IRIX Base Documentation 2002 November

home *** CD-ROM | disk | FTP | other *** search

/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / Xm / XmContainer.z / XmContainer

Wrap

Text File | 2002-10-03 | 189.8 KB | 2,575 lines

XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX)))) NNNNAAAAMMMMEEEE XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr - The Container widget class SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS #include <Xm/Container.h> VVVVEEEERRRRSSSSIIIIOOOONNNN This page documents Motif 2.1. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN Container manages child widgets that have the CCCCoooonnnnttttaaaaiiiinnnneeeerrrrIIIItttteeeemmmm trait. These child widgets can be viewed in several different layout formats, selected using different selection types and techniques, and directly manipulated by the user. Three different formats or views are supported by the Container. They are specified via the XXXXmmmmNNNNeeeennnnttttrrrryyyyVVVViiiieeeewwwwTTTTyyyyppppeeee resource: +o XXXXmmmmLLLLAAAARRRRGGGGEEEE____IIIICCCCOOOONNNN +o XXXXmmmmSSSSMMMMAAAALLLLLLLL____IIIICCCCOOOONNNN +o XXXXmmmmAAAANNNNYYYY____IIIICCCCOOOONNNN Three different layout types are supported by the Container. They are specified by the XXXXmmmmNNNNllllaaaayyyyoooouuuuttttTTTTyyyyppppeeee resource: +o XXXXmmmmSSSSPPPPAAAATTTTIIIIAAAALLLL +o XXXXmmmmOOOOUUUUTTTTLLLLIIIINNNNEEEE +o XXXXmmmmDDDDEEEETTTTAAAAIIIILLLL In the XXXXmmmmSSSSPPPPAAAATTTTIIIIAAAALLLL layout type, several other resources (XXXXmmmmNNNNssssppppaaaattttiiiiaaaallllSSSSttttyyyylllleeee, XXXXmmmmNNNNssssppppaaaattttiiiiaaaallllIIIInnnncccclllluuuuddddeeeeMMMMooooddddeeeellll, XXXXmmmmNNNNssssppppaaaattttiiiiaaaallllSSSSnnnnaaaappppMMMMooooddddeeeellll) control the positioning of the items within the Container; an application programmer can specify these resources so that the Container strictly enforces the position of each item or so that the Container positions items according to constraint resources specified for each item. The user, however, can alter the position of an item in the XXXXmmmmSSSSPPPPAAAATTTTIIIIAAAALLLLlayout type within the Container by direct manipulation; for example, by pressing BBBBTTTTrrrraaaannnnssssffffeeeerrrr over the item and then dragging and releasing BBBBTTTTrrrraaaannnnssssffffeeeerrrrover some location within the Container. In the XXXXmmmmOOOOUUUUTTTTLLLLIIIINNNNEEEE layout type, the Container controls the positioning of the items. Items within the Container can have parent-child relationships between them. Each item's XXXXmmmmNNNNeeeennnnttttrrrryyyyPPPPaaaarrrreeeennnntttt resource can specify another item in the same Container as its parent; items with a non-NULL value for Page 1 (printed 10/3/02) XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX)))) XXXXmmmmNNNNeeeennnnttttrrrryyyyPPPPaaaarrrreeeennnntttt can only be displayed in the XXXXmmmmOOOOUUUUTTTTLLLLIIIINNNNEEEE layout type. In the XXXXmmmmOOOOUUUUTTTTLLLLIIIINNNNEEEE layout type, items are positioned in a tree configuration with connecting lines drawn to illustrate the relationships. Items are positioned top to bottom in the order specified by XXXXmmmmNNNNppppoooossssiiiittttiiiioooonnnnIIIInnnnddddeeeexxxx within their parent. Container positions a PushButton next to each item that has a parent relationship to other items. The PushButton contains a pixmap to illustrate whether the child items are shown or not; the user can activate the PushButton to toggle between showing or hiding the child items. Direct manipulation to alter the position of the item is not supported in the XXXXmmmmOOOOUUUUTTTTLLLLIIIINNNNEEEE layout type. Note that the XXXXmmmmNNNNttttrrrraaaavvvveeeerrrrssssaaaallllOOOOnnnn resource of the PushButtons created by Container are set to False. The XXXXmmmmDDDDEEEETTTTAAAAIIIILLLL layout type is the same as XXXXmmmmOOOOUUUUTTTTLLLLIIIINNNNEEEE, except that each item can also display additional information as rows in columns with column headers specified in the XXXXmmmmNNNNddddeeeettttaaaaiiiillllCCCCoooolllluuuummmmnnnnHHHHeeeeaaaaddddiiiinnnnggggresources. In each item row, the item's detail information (see the reference page on XXXXmmmmIIIIccccoooonnnnGGGGaaaaddddggggeeeetttt for a description of the _X_m_N_e_n_t_r_y_D_e_t_a_i_l resource) is displayed. Items are positioned top to bottom in the order specified by XXXXmmmmNNNNppppoooossssiiiittttiiiioooonnnnIIIInnnnddddeeeexxxx within the parent. SSSSeeeelllleeeeccccttttiiiioooonnnn When a child widget of the container is selected, the container specifies that the item should display the appropriate visual information to the user via the CCCCoooonnnnttttaaaaiiiinnnneeeerrrrIIIItttteeeemmmm trait. The application program is notified of selection changes through XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk. The container uses four selection policies: +o Single +o Browse +o Multiple +o Extended In Single Select and Browse Select modes, only one item can be selected at a time. Pressing BBBBSSSSeeeelllleeeecccctttton an item selects it and deselects any other selected item. Pressing BBBBSSSSeeeelllleeeecccctttt over an empty space in the Container deselects all items. In Browse Select, dragging BBBBSSSSeeeelllleeeecccctttt moves the selection as the pointer is moved. In Multiple Select and Extended Select modes, any number of items can be selected at the same time. In Multiple Select, pressing and dragging BBBBSSSSeeeelllleeeecccctttt or BBBBEEEExxxxtttteeeennnndddd to specify an item, Page 2 (printed 10/3/02) XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX)))) range of items, or group of discontiguous items causes the selection states of those items to be toggled. In Extended Select, pressing and dragging BBBBSSSSeeeelllleeeecccctttt to indicate an item, range of items, or group of discontiguous items selects those items and deselects all others. Pressing and dragging BBBBEEEExxxxtttteeeennnndddd in Extended Select to indicate an item, range of items, or discontiguous group of items causes the selection states of those items to be toggled. Several techniques are available to indicate an item, range of items, or group of discontiguous items in the Multiple Select and Extended Select modes. In the XXXXmmmmSSSSPPPPAAAATTTTIIIIAAAALLLL and XXXXmmmmOOOOUUUUTTTTLLLLIIIINNNNEEEE layout types, the XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnTTTTeeeecccchhhhnnnniiiiqqqquuuueeee resource specifies the techniques to be used to indicate items. The default specification of XXXXmmmmTTTTOOOOUUUUCCCCHHHH____OOOOVVVVEEEERRRRallows both the Random-Swipe and Marquee techniques to be used when _X_m_N_l_a_y_o_u_t_S_t_y_l_e is XXXXmmmmSSSSPPPPAAAATTTTIIIIAAAALLLL. The default specification of XXXXmmmmTTTTOOOOUUUUCCCCHHHH____OOOOVVVVEEEERRRR allows the Range- Swipe, Range-Click, and Marquee techniques to be used when _X_m_N_l_a_y_o_u_t_S_t_y_l_e is XXXXmmmmOOOOUUUUTTTTLLLLIIIINNNNEEEE. Discontiguous groups of items can be selected using the Random-Swipe technique. In the Random-Swipe technique, pressing BBBBSSSSeeeelllleeeecccctttt (or BBBBEEEExxxxtttteeeennnndddd) over an item and dragging BBBBSSSSeeeelllleeeecccctttt over other items selects all of those items. Only those items that pointer passed over are selected. In the Range-Swipe technique, the user presses BBBBSSSSeeeelllleeeecccctttt (or BBBBEEEExxxxtttteeeennnndddd) over the first item and releases BBBBSSSSeeeelllleeeecccctttt over the last item; all items within the range between the first and last item are selected whether the pointer actually passed over them or not. In the Range-Click technique, the user presses and releases BBBBSSSSeeeelllleeeecccctttt (or BBBBEEEExxxxtttteeeennnndddd) over the first item and then presses and releases BBBBEEEExxxxtttteeeennnndddd over the last item. In the Marquee technique, pressing BBBBSSSSeeeelllleeeecccctttt (or BBBBEEEExxxxtttteeeennnndddd) over a blank space within the Container indicates the starting point of a Marquee rectangle. Dragging BBBBSSSSeeeelllleeeecccctttt draws a Marquee rectangle (rubberband line) between the starting point and current pointer. All items completely within the Marquee rectangle are selected. Specifying XXXXmmmmTTTTOOOOUUUUCCCCHHHH____OOOONNNNLLLLYYYY for XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnTTTTeeeecccchhhhnnnniiiiqqqquuuueeee enforces the Random-Swipe technique even when BBBBSSSSeeeelllleeeecccctttt (or BBBBEEEExxxxtttteeeennnndddd) is pressed over a blank space. Similarly, specifying XXXXmmmmMMMMAAAARRRRQQQQUUUUEEEEEEEE enforces the Marquee technique even when BBBBSSSSeeeelllleeeecccctttt (or BBBBEEEExxxxtttteeeennnndddd) is pressed over an item; since the item over which the press occurs is only partially included in the Marquee rectangle, it is not selected. XXXXmmmmMMMMAAAARRRRQQQQUUUUEEEEEEEE____EEEEXXXXTTTTEEEENNNNDDDD____SSSSTTTTAAAARRRRTTTT and XXXXmmmmMMMMAAAARRRRQQQQUUUUEEEEEEEE____EEEEXXXXTTTTEEEENNNNDDDD____BBBBOOOOTTTTHHHH enforce the Marquee technique and also Page 3 (printed 10/3/02) XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX)))) cause the rectangle to extend automatically around the first item indicated and, for XXXXmmmmMMMMAAAARRRRQQQQUUUUEEEEEEEE____EEEEXXXXTTTTEEEENNNNDDDD____BBBBOOOOTTTTHHHH, the last item. In the XXXXmmmmDDDDEEEETTTTAAAAIIIILLLL layout type, the Range-Swipe and Range-Click techniques are available to indicate a range of items for selection. Container uses the _X_m_Q_T_c_o_n_t_a_i_n_e_r_I_t_e_m, _X_m_Q_T_s_c_r_o_l_l_F_r_a_m_e, and _X_m_Q_T_s_p_e_c_i_f_y_R_e_n_d_e_r_T_a_b_l_etraits and holds the XXXXmmmmQQQQTTTTccccoooonnnnttttaaaaiiiinnnneeeerrrr and _X_m_Q_T_t_r_a_n_s_f_e_r traits. DDDDaaaattttaaaa TTTTrrrraaaannnnssssffffeeeerrrr BBBBeeeehhhhaaaavvvviiiioooorrrr Container supports dragging of selected items from the widget. Depending on the value of XXXXmmmmNNNNpppprrrriiiimmmmaaaarrrryyyyOOOOwwwwnnnneeeerrrrsssshhhhiiiipppp, Container can also support primary selection. As a source of data, Container supports the following targets and associated conversions of data to these targets: _l_o_c_a_l_e If the _l_o_c_a_l_e target matches the widget's locale, the widget transfers the selected items in the encoding of the locale. The value for each item transferred, except the last, includes a trailing separator. Each item value is the XXXXmmmmNNNNllllaaaabbbbeeeellllSSSSttttrrrriiiinnnngggg of the item. _C_O_M_P_O_U_N_D__T_E_X_T The widget transfers the selected items as type _C_O_M_P_O_U_N_D__T_E_X_T. The value for each item transferred, except the last, includes a trailing separator. Each item value is the XXXXmmmmNNNNllllaaaabbbbeeeellllSSSSttttrrrriiiinnnngggg of the item. _D_E_L_E_T_E The widget deletes the selected items. _P_I_X_M_A_P The widget transfers a list of the pixmap IDs of the selected items as type _D_R_A_W_A_B_L_E. _S_T_R_I_N_G The widget transfers the selected items as type _S_T_R_I_N_G. The value for each item transferred, except the last, includes a trailing separator. Each item value is the XXXXmmmmNNNNllllaaaabbbbeeeellllSSSSttttrrrriiiinnnngggg of the item. _T_E_X_T If the selected items are fully convertible to the encoding of the locale, the widget transfers the selected items in the encoding of the locale. Otherwise, the widget transfers the selected items as type _C_O_M_P_O_U_N_D__T_E_X_T. The value for each item transferred, except the last, includes a trailing separator. Each item value is the XXXXmmmmNNNNllllaaaabbbbeeeellllSSSSttttrrrriiiinnnngggg of the item. Page 4 (printed 10/3/02) XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX)))) ____MMMMOOOOTTTTIIIIFFFF____CCCCLLLLIIIIPPPPBBBBOOOOAAAARRRRDDDD____TTTTAAAARRRRGGGGEEEETTTTSSSS The widget transfers, as type _A_T_O_M, a list of the targets it supports for immediate transfer for the _C_L_I_P_B_O_A_R_D selection. These include ____MMMMOOOOTTTTIIIIFFFF____CCCCOOOOMMMMPPPPOOOOUUUUNNNNDDDD____SSSSTTTTRRRRIIIINNNNGGGG and _P_I_X_M_A_P. If the selected items are fully convertible to _S_T_R_I_N_G, these also include _S_T_R_I_N_G; otherwise, they also include _C_O_M_P_O_U_N_D__T_E_X_T. ____MMMMOOOOTTTTIIIIFFFF____CCCCOOOOMMMMPPPPOOOOUUUUNNNNDDDD____SSSSTTTTRRRRIIIINNNNGGGG The widget transfers the selected items as a compound string in Byte Stream format. The value for each item transferred, except the last, includes a trailing separator. Each item value is the XXXXmmmmNNNNllllaaaabbbbeeeellllSSSSttttrrrriiiinnnngggg of the item. ____MMMMOOOOTTTTIIIIFFFF____DDDDEEEEFFFFEEEERRRRRRRREEEEDDDD____CCCCLLLLIIIIPPPPBBBBOOOOAAAARRRRDDDD____TTTTAAAARRRRGGGGEEEETTTTSSSS The widget transfers, as type _A_T_O_M, a list of the targets it supports for delayed transfer for the _C_L_I_P_B_O_A_R_D selection. This widget currently supplies no targets for ____MMMMOOOOTTTTIIIIFFFF____DDDDEEEEFFFFEEEERRRRRRRREEEEDDDD____CCCCLLLLIIIIPPPPBBBBOOOOAAAARRRRDDDD____TTTTAAAARRRRGGGGEEEETTTTSSSS. ____MMMMOOOOTTTTIIIIFFFF____DDDDRRRRAAAAGGGG____OOOOFFFFFFFFSSSSEEEETTTT The widget transfers a list of two 16-bit numbers, of type _I_N_T_E_G_E_R, representing an x and y offset for an item being dragged. This offset is calculated so that, if the offset were added to the x and y coordinates at the drop site, and the dragged pixmap placed at that position, it would correspond to the position the user would expect the pixmap to placed at, based on the drag icon used at the drop site. ____MMMMOOOOTTTTIIIIFFFF____EEEEXXXXPPPPOOOORRRRTTTT____TTTTAAAARRRRGGGGEEEETTTTSSSS The widget transfers, as type _A_T_O_M, a list of the targets to be used as the value of the DragContext's XXXXmmmmNNNNeeeexxxxppppoooorrrrttttTTTTaaaarrrrggggeeeettttssss in a drag-and-drop transfer. These include ____MMMMOOOOTTTTIIIIFFFF____CCCCOOOOMMMMPPPPOOOOUUUUNNNNDDDD____SSSSTTTTRRRRIIIINNNNGGGG, _P_I_X_M_A_P, _C_O_M_P_O_U_N_D__T_E_X_T, the encoding of the locale, _S_T_R_I_N_G, _T_E_X_T, _B_A_C_K_G_R_O_U_N_D, and _F_O_R_E_G_R_O_U_N_D. As a source of data, Container also supports the following standard Motif targets: _B_A_C_K_G_R_O_U_N_D The widget transfers XXXXmmmmNNNNbbbbaaaacccckkkkggggrrrroooouuuunnnndddd as type _P_I_X_E_L. _C_L_A_S_S The widget finds the first shell in the widget hierarchy that has a WWWWMMMM____CCCCLLLLAAAASSSSSSSS property and transfers the contents as text in the current locale. Page 5 (printed 10/3/02) XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX)))) _C_L_I_E_N_T__W_I_N_D_O_W The widget finds the first shell in the widget hierarchy and transfers its window as type _W_I_N_D_O_W. _C_O_L_O_R_M_A_P The widget transfers XXXXmmmmNNNNccccoooolllloooorrrrmmmmaaaapppp as type _C_O_L_O_R_M_A_P. _F_O_R_E_G_R_O_U_N_D The widget transfers XXXXmmmmNNNNffffoooorrrreeeeggggrrrroooouuuunnnndddd as type _P_I_X_E_L. _N_A_M_E The widget finds the first shell in the widget hierarchy that has a WWWWMMMM____NNNNAAAAMMMMEEEE property and transfers the contents as text in the current locale. _T_A_R_G_E_T_S The widget transfers, as type _A_T_O_M, a list of the targets it supports. These include the standard targets in this list. These also include ____MMMMOOOOTTTTIIIIFFFF____CCCCOOOOMMMMPPPPOOOOUUUUNNNNDDDD____SSSSTTTTRRRRIIIINNNNGGGG, _P_I_X_M_A_P, _C_O_M_P_O_U_N_D__T_E_X_T, the encoding of the locale, _S_T_R_I_N_G, and _T_E_X_T. _T_I_M_E_S_T_A_M_P The widget transfers the timestamp used to acquire the selection as type _I_N_T_E_G_E_R. ____MMMMOOOOTTTTIIIIFFFF____RRRREEEENNNNDDDDEEEERRRR____TTTTAAAABBBBLLLLEEEE The widget transfers XXXXmmmmNNNNrrrreeeennnnddddeeeerrrrTTTTaaaabbbblllleeee if it exists, or else the default text render table, as type _S_T_R_I_N_G. ____MMMMOOOOTTTTIIIIFFFF____EEEENNNNCCCCOOOODDDDIIIINNNNGGGG____RRRREEEEGGGGIIIISSSSTTTTRRRRYYYY The widget transfers its encoding registry as type _S_T_R_I_N_G. The value is a list of NULL separated items in the form of tag encoding pairs. This target symbolizes the transfer target for the Motif Segment Encoding Registry. Widgets and applications can use this Registry to register text encoding formats for specified render table tags. Applications access this Registry by calling XXXXmmmmRRRReeeeggggiiiisssstttteeeerrrrSSSSeeeeggggmmmmeeeennnnttttEEEEnnnnccccooooddddiiiinnnngggg and XXXXmmmmMMMMaaaappppSSSSeeeeggggmmmmeeeennnnttttEEEEnnnnccccooooddddiiiinnnngggg. As a destination for data, Container supports only the dropping of items being dragged from the same widget. Subclasses and the XXXXmmmmNNNNddddeeeessssttttiiiinnnnaaaattttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk procedures are responsible for any other data transfers to the widget. CCCCllllaaaasssssssseeeessss Container inherits behavior, resources, and traits from the CCCCoooorrrreeee, CCCCoooommmmppppoooossssiiiitttteeee, CCCCoooonnnnssssttttrrrraaaaiiiinnnntttt, and XXXXmmmmMMMMaaaannnnaaaaggggeeeerrrr classes. The class pointer is _x_m_C_o_n_t_a_i_n_e_r_W_i_d_g_e_t_C_l_a_s_s. The class name is XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr. Page 6 (printed 10/3/02) XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX)))) NNNNeeeewwww RRRReeeessssoooouuuurrrrcccceeeessss The following table defines a set of widget resources used by the programmer to specify data. The programmer can also set the resource values for the inherited classes to set attributes for this widget. To reference a resource by name or by class in a ....XXXXddddeeeeffffaaaauuuullllttttssss file, remove the XXXXmmmmNNNN or XXXXmmmmCCCC prefix and use the remaining letters. To specify one of the defined values for a resource in a ....XXXXddddeeeeffffaaaauuuullllttttssssfile, remove the XXXXmmmm prefix and use the remaining letters (in either lowercase or uppercase, but include any underscores between words). The codes in the access column indicate whether the given resource can be set at creation time (C), set by using XXXXttttSSSSeeeettttVVVVaaaalllluuuueeeessss(S), retrieved by using XXXXttttGGGGeeeettttVVVVaaaalllluuuueeeessss (G), or is not applicable (N/A). XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt NNNNaaaammmmeeee CCCCllllaaaassssssss TTTTyyyyppppeeee DDDDeeeeffffaaaauuuulllltttt AAAAcccccccceeeessssssss XmNautomaticSelection XmCAutomaticSelection unsigned char XmAUTO_SELECT CSG XmNcollapsedStatePixmap XmCCollapsedStatePixmap Pixmap dynamic CSG XmNconvertCallback XmCCallback XtCallbackList NULL C XmNdefaultActionCallback XmCCallback XtCallbackList NULL C XmNdestinationCallback XmCCallback XtCallbackList NULL C XmNdetailColumnHeading XmCDetailColumnHeading XmStringTable NULL CSG XmNdetailColumnHeadingCount XmCDetailColumnHeadingCount Cardinal 0 CSG XmNdetailOrder XmCDetailOrder Cardinal * NULL CSG XmNdetailOrderCount XmCDetailOrderCount Cardinal dynamic CSG XmNdetailTabList XmCDetailTabList XmTabList NULL CSG XmNentryViewType XmCEntryViewType unsigned char XmANY_ICON CSG XmNexpandedStatePixmap XmCExpandedStatePixmap Pixmap dynamic CSG XmNfontList XmCFontList XmFontList NULL CSG XmNlargeCellHeight XmCCellHeight Dimension dynamic CSG XmNlargeCellWidth XmCCellWidth Dimension dynamic CSG XmNlayoutType XmCLayoutType unsigned char XmSPATIAL CSG XmNmarginHeight XmCMarginHeight Dimension 0 CSG XmNmarginWidth XmCMarginWidth Dimension 0 CSG XmNoutlineButtonPolicy XmCOutlineButtonPolicy unsigned char XmOUTLINE_BUTTON_PRESENT CSG XmNoutlineChangedCallback XmCCallback XtCallbackList NULL C XmNoutlineColumnWidth XmCOutlineColumnWidth Dimension dynamic CSG XmNoutlineIndentation XmCOutlineIndentation Dimension 40 CSG XmNoutlineLineStyle XmCLineStyle unsigned char XmSINGLE CSG XmNprimaryOwnership XmCprimaryOwnership unsigned char XmOWN_POSSIBLE_MULTIPLE CSG XmNrenderTable XmCRenderTable XmRenderTable dynamic CSG XmNselectColor XmCSelectColor Pixel dynamic CSG XmNselectedObjects XmCSelectedObjects WidgetList NULL SG XmNselectedObjectCount XmCSelectedObjectCount unsigned int 0 SG XmNselectionCallback XmCCallback XtCallbackList NULL C XmNselectionPolicy XmCSelectionPolicy unsigned char XmEXTENDED_SELECT CSG XmNselectionTechnique XmCSelectionTechnique unsigned char XmTOUCH_OVER CSG XmNsmallCellHeight XmCCellHeight Dimension dynamic CSG XmNsmallCellWidth XmCCellWidth Dimension dynamic CSG Page 7 (printed 10/3/02) XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX)))) XmNspatialIncludeModel XmCSpatialIncludeModel unsigned char XmAPPEND CSG XmNspatialResizeModel XmCSpatialResizeModel unsigned char XmGROW_MINOR CSG XmNspatialSnapModel XmCSpatialSnapModel unsigned char XmNONE CSG XmNspatialStyle XmCSpatialStyle unsigned char XmGRID CSG XXXXmmmmNNNNaaaauuuuttttoooommmmaaaattttiiiiccccSSSSeeeelllleeeeccccttttiiiioooonnnn Indicates whether the Container invokes selection callbacks when each item is selected (or toggled) or whether selection callbacks are not invoked until the user has completed selection actions (for example, the user has released the mouse button). It can have one of the following values: XXXXmmmmAAAAUUUUTTTTOOOO____SSSSEEEELLLLEEEECCCCTTTT Makes selection callbacks automatically when each item is selected or toggled. This may also be the value TTTTRRRRUUUUEEEE. XXXXmmmmNNNNOOOO____AAAAUUUUTTTTOOOO____SSSSEEEELLLLEEEECCCCTTTT Delays selection callbacks until the user has finished selection actions. This may also be the value FFFFAAAALLLLSSSSEEEE. XXXXmmmmNNNNccccoooollllllllaaaappppsssseeeeddddSSSSttttaaaatttteeeePPPPiiiixxxxmmmmaaaapppp Specifies the pixmap to display on a PushButton next to a Container item with child items, when XXXXmmmmNNNNoooouuuuttttlllliiiinnnneeeeBBBBuuuuttttttttoooonnnnPPPPoooolllliiiiccccyyyy is XXXXmmmmOOOOUUUUTTTTLLLLIIIINNNNEEEE____BBBBUUUUTTTTTTTTOOOONNNN____PPPPRRRREEEESSSSEEEENNNNTTTT. XXXXmmmmNNNNccccoooollllllllaaaappppsssseeeeddddSSSSttttaaaatttteeeePPPPiiiixxxxmmmmaaaapppp indicates that the child items are not displayed. If set to XXXXmmmmUUUUNNNNSSSSPPPPEEEECCCCIIIIFFFFIIIIEEEEDDDD____PPPPIIIIXXXXMMMMAAAAPPPP, a default pixmap showing an arrow pointing up is used. XXXXmmmmNNNNccccoooonnnnvvvveeeerrrrttttCCCCaaaallllllllbbbbaaaacccckkkk Specifies a list of callbacks called when the Container is asked to convert a selection. The type of the structure whose address is passed to these callbacks is XXXXmmmmCCCCoooonnnnvvvveeeerrrrttttCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt. The reason is XXXXmmmmCCCCRRRR____OOOOKKKK. XXXXmmmmNNNNddddeeeeffffaaaauuuullllttttAAAAccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk Specifies a list of callbacks to call when the user double-clicks an item or presses <<<<EEEEnnnntttteeeerrrr>>>> or <<<<RRRReeeettttuuuurrrrnnnn>>>> over an item. The callback structure is XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrrSSSSeeeelllleeeeccccttttCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt. The reason is XXXXmmmmCCCCRRRR____DDDDEEEEFFFFAAAAUUUULLLLTTTT____AAAACCCCTTTTIIIIOOOONNNN. XXXXmmmmNNNNddddeeeessssttttiiiinnnnaaaattttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk Specifies a list of callbacks called when the Container is the destination of a transfer operation. The type of the structure whose address is passed to these callbacks is XXXXmmmmDDDDeeeessssttttiiiinnnnaaaattttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt. The reason is Page 8 (printed 10/3/02) XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX)))) XXXXmmmmCCCCRRRR____OOOOKKKK. XXXXmmmmNNNNddddeeeettttaaaaiiiillllCCCCoooolllluuuummmmnnnnHHHHeeeeaaaaddddiiiinnnngggg Specifies a table of XXXXmmmmSSSSttttrrrriiiinnnnggggs to display as the headings to columns. If NULL, or if XXXXmmmmNNNNllllaaaayyyyoooouuuuttttTTTTyyyyppppeeeeis not XXXXmmmmDDDDEEEETTTTAAAAIIIILLLL, no heading is displayed. XXXXmmmmNNNNddddeeeettttaaaaiiiillllCCCCoooolllluuuummmmnnnnHHHHeeeeaaaaddddiiiinnnnggggCCCCoooouuuunnnntttt Specifies a count of XXXXmmmmSSSSttttrrrriiiinnnnggggs in the table specified for XXXXmmmmNNNNddddeeeettttaaaaiiiillllCCCCoooolllluuuummmmnnnnHHHHeeeeaaaaddddiiiinnnngggg. XXXXmmmmNNNNddddeeeettttaaaaiiiillllOOOOrrrrddddeeeerrrr Specifies an array of CCCCaaaarrrrddddiiiinnnnaaaalllls that indicate which column detail information, and in which order, each Container child will display its detail information. This resource is ignored if XXXXmmmmNNNNllllaaaayyyyoooouuuuttttTTTTyyyyppppeeee is not XXXXmmmmDDDDEEEETTTTAAAAIIIILLLL. If NULL, the the default behavior is determined by XXXXmmmmNNNNddddeeeettttaaaaiiiillllOOOOrrrrddddeeeerrrrCCCCoooouuuunnnntttt. XXXXmmmmNNNNddddeeeettttaaaaiiiillllOOOOrrrrddddeeeerrrrCCCCoooouuuunnnntttt Specifies a count of CCCCaaaarrrrddddiiiinnnnaaaalllls in the array specified for XXXXmmmmNNNNddddeeeettttaaaaiiiillllOOOOrrrrddddeeeerrrr. If XXXXmmmmNNNNddddeeeettttaaaaiiiillllOOOOrrrrddddeeeerrrr is NULL and XXXXmmmmNNNNddddeeeettttaaaaiiiillllOOOOrrrrddddeeeerrrrCCCCoooouuuunnnntttt is not 0, then each Container child displays its detail information in order from column 1 to the XXXXmmmmNNNNddddeeeettttaaaaiiiillllOOOOrrrrddddeeeerrrrCCCCoooouuuunnnntttt column number. If XXXXmmmmNNNNddddeeeettttaaaaiiiillllOOOOrrrrddddeeeerrrrCCCCoooouuuunnnnttttis 0, then a default is calculated from the detail order count information of each item accessed via the CCCCoooonnnnttttaaaaiiiinnnneeeerrrrIIIItttteeeemmmm trait. XXXXmmmmNNNNddddeeeettttaaaaiiiillllTTTTaaaabbbbLLLLiiiisssstttt Indicates an XXXXmmmmTTTTaaaabbbbLLLLiiiisssstttt specifying the start of each column in the XXXXmmmmDDDDEEEETTTTAAAAIIIILLLL layout. If this resource is set to NULL, then Container calculates an XXXXmmmmTTTTaaaabbbbLLLLiiiisssstttt. This resource is ignored if XXXXmmmmNNNNllllaaaayyyyoooouuuuttttTTTTyyyyppppeeee is not XXXXmmmmDDDDEEEETTTTAAAAIIIILLLL. XXXXmmmmNNNNeeeennnnttttrrrryyyyVVVViiiieeeewwwwTTTTyyyyppppeeee Specifies the view type for all Container children. The view type is specified for each item via the CCCCoooonnnnttttaaaaiiiinnnneeeerrrrIIIItttteeeemmmm trait. It can have one of the following values: XXXXmmmmAAAANNNNYYYY____IIIICCCCOOOONNNN No specification is made for Container children. Children use their own default specifications. XXXXmmmmLLLLAAAARRRRGGGGEEEE____IIIICCCCOOOONNNN The view type for all children is Page 9 (printed 10/3/02) XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX)))) XXXXmmmmLLLLAAAARRRRGGGGEEEE____IIIICCCCOOOONNNN. XXXXmmmmSSSSMMMMAAAALLLLLLLL____IIIICCCCOOOONNNN The view type for all children is XXXXmmmmSSSSMMMMAAAALLLLLLLL____IIIICCCCOOOONNNN. XXXXmmmmNNNNeeeexxxxppppaaaannnnddddeeeeddddSSSSttttaaaatttteeeePPPPiiiixxxxmmmmaaaapppp Specifies the pixmap to display on a PushButton next to a Container item with child items, when XXXXmmmmNNNNoooouuuuttttlllliiiinnnneeeeBBBBuuuuttttttttoooonnnnPPPPoooolllliiiiccccyyyy is XXXXmmmmOOOOUUUUTTTTLLLLIIIINNNNEEEE____BBBBUUUUTTTTTTTTOOOONNNN____PPPPRRRREEEESSSSEEEENNNNTTTT. XXXXmmmmNNNNeeeexxxxppppaaaannnnddddeeeeddddSSSSttttaaaatttteeeePPPPiiiixxxxmmmmaaaapppp indicates that the child items are displayed. If set to XXXXmmmmUUUUNNNNSSSSPPPPEEEECCCCIIIIFFFFIIIIEEEEDDDD____PPPPIIIIXXXXMMMMAAAAPPPP, a default pixmap showing an arrow pointing down is used. XXXXmmmmNNNNffffoooonnnnttttLLLLiiiisssstttt Specifies the fontlist associated with XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr. The fontlist is an obsolete construct and has been superseded by the render table. It is included for compatibility with earlier versions of Motif, and for applications that do not easily support render tables. The default fontlist is derived from the default render table; and if both a fontlist and a render table are specified, the render table takes precedence. XXXXmmmmNNNNllllaaaarrrrggggeeeeCCCCeeeellllllllHHHHeeeeiiiigggghhhhtttt Specifies the height of a cell for XXXXmmmmGGGGRRRRIIIIDDDD or XXXXmmmmCCCCEEEELLLLLLLLSSSS spatial style when XXXXmmmmNNNNeeeennnnttttrrrryyyyVVVViiiieeeewwwwTTTTyyyyppppeeee is XXXXmmmmLLLLAAAARRRRGGGGEEEE____IIIICCCCOOOONNNN or XXXXmmmmAAAANNNNYYYY____IIIICCCCOOOONNNN. XXXXmmmmNNNNllllaaaarrrrggggeeeeCCCCeeeellllllllWWWWiiiiddddtttthhhh Specifies the width of a cell for XXXXmmmmGGGGRRRRIIIIDDDD or XXXXmmmmCCCCEEEELLLLLLLLSSSS spatial style when XXXXmmmmNNNNeeeennnnttttrrrryyyyVVVViiiieeeewwwwTTTTyyyyppppeeee is XXXXmmmmLLLLAAAARRRRGGGGEEEE____IIIICCCCOOOONNNN or XXXXmmmmAAAANNNNYYYY____IIIICCCCOOOONNNN. XXXXmmmmNNNNllllaaaayyyyoooouuuuttttTTTTyyyyppppeeee Specifies the policy for laying out child widgets within the Container. It can have one of the following values: XXXXmmmmDDDDEEEETTTTAAAAIIIILLLL Displays items in the same manner as when the resource is XXXXmmmmOOOOUUUUTTTTLLLLIIIINNNNEEEE, except that each item displays detail information next to it. XXXXmmmmOOOOUUUUTTTTLLLLIIIINNNNEEEE Displays items in a tree configuration, in XXXXmmmmNNNNppppoooossssiiiittttiiiioooonnnnIIIInnnnddddeeeexxxx within XXXXmmmmNNNNeeeennnnttttrrrryyyyPPPPaaaarrrreeeennnntttt order, with connecting lines drawn to show their parent-child relationships. Page 10 (printed 10/3/02) XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX)))) XXXXmmmmSSSSPPPPAAAATTTTIIIIAAAALLLL Displays items according to XXXXmmmmNNNNssssppppaaaattttiiiiaaaallllSSSSttttyyyylllleeee. Items with XXXXmmmmNNNNeeeennnnttttrrrryyyyPPPPaaaarrrreeeennnntttt values are not displayed. XXXXmmmmNNNNmmmmaaaarrrrggggiiiinnnnHHHHeeeeiiiigggghhhhtttt Specifies the margin spacing at the top and bottom of the Container. XXXXmmmmNNNNmmmmaaaarrrrggggiiiinnnnWWWWiiiiddddtttthhhh Specifies the margin spacing at the left and right sides of the Container. XXXXmmmmNNNNoooouuuuttttlllliiiinnnneeeeBBBBuuuuttttttttoooonnnnPPPPoooolllliiiiccccyyyy Specifies whether or not to display buttons for users to expand and collapse the display of items. It can have one of the following values: XXXXmmmmOOOOUUUUTTTTLLLLIIIINNNNEEEE____BBBBUUUUTTTTTTTTOOOONNNN____AAAABBBBSSSSEEEENNNNTTTT Do not display the outline buttons. XXXXmmmmOOOOUUUUTTTTLLLLIIIINNNNEEEE____BBBBUUUUTTTTTTTTOOOONNNN____PPPPRRRREEEESSSSEEEENNNNTTTT Display the outline buttons. XXXXmmmmNNNNoooouuuuttttlllliiiinnnneeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkk Specifies a list of callbacks to call when an item's XXXXmmmmNNNNoooouuuuttttlllliiiinnnneeeeSSSSttttaaaatttteeeeis changed. The callback structure is XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrrOOOOuuuuttttlllliiiinnnneeeeCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt. The reason is XXXXmmmmCCCCRRRR____CCCCOOOOLLLLLLLLAAAAPPPPSSSSEEEEDDDD or XXXXmmmmCCCCRRRR____EEEEXXXXPPPPAAAANNNNDDDDEEEEDDDD, depending on the new value of XXXXmmmmNNNNoooouuuuttttlllliiiinnnneeeeSSSSttttaaaatttteeee. XXXXmmmmNNNNoooouuuuttttlllliiiinnnneeeeCCCCoooolllluuuummmmnnnnWWWWiiiiddddtttthhhh Specifies the width of the first column displayed when XXXXmmmmNNNNllllaaaayyyyoooouuuuttttTTTTyyyyppppeeeeis XXXXmmmmDDDDEEEETTTTAAAAIIIILLLL. Specifies the preferred width of the Container (without the margins) when XXXXmmmmNNNNllllaaaayyyyoooouuuuttttTTTTyyyyppppeeee is XXXXmmmmOOOOUUUUTTTTLLLLIIIINNNNEEEE. If not specified, Container will determine a default value equal to the widest space necessary to display an item's pixmap and XXXXmmmmNNNNoooouuuuttttlllliiiinnnneeeeIIIInnnnddddeeeennnnttttaaaattttiiiioooonnnn. XXXXmmmmNNNNoooouuuuttttlllliiiinnnneeeeIIIInnnnddddeeeennnnttttaaaattttiiiioooonnnn Specifies the distance to indent for the display of child items when XXXXmmmmNNNNllllaaaayyyyoooouuuuttttTTTTyyyyppppeeee is XXXXmmmmOOOOUUUUTTTTLLLLIIIINNNNEEEE or XXXXmmmmDDDDEEEETTTTAAAAIIIILLLL. XXXXmmmmNNNNoooouuuuttttlllliiiinnnneeeeLLLLiiiinnnneeeeSSSSttttyyyylllleeee Specifies whether to draw lines between items with parent-child relationships when XXXXmmmmNNNNllllaaaayyyyoooouuuuttttTTTTyyyyppppeeeeis XXXXmmmmOOOOUUUUTTTTLLLLIIIINNNNEEEE or XXXXmmmmDDDDEEEETTTTAAAAIIIILLLL. It can have one of the following values: XXXXmmmmNNNNOOOO____LLLLIIIINNNNEEEE Draws no line. Page 11 (printed 10/3/02) XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX)))) XXXXmmmmSSSSIIIINNNNGGGGLLLLEEEE Draws a line one pixel wide. XXXXmmmmNNNNpppprrrriiiimmmmaaaarrrryyyyOOOOwwwwnnnneeeerrrrsssshhhhiiiipppp Specifies whether Container takes ownership of the primary selection when a selection is made inside it. This resource can take the following values: XXXXmmmmOOOOWWWWNNNN____NNNNEEEEVVVVEEEERRRR Never takes ownership. XXXXmmmmOOOOWWWWNNNN____AAAALLLLWWWWAAAAYYYYSSSS Always takes ownership. XXXXmmmmOOOOWWWWNNNN____MMMMUUUULLLLTTTTIIIIPPPPLLLLEEEE Only takes ownership if more than one element has been selected. XXXXmmmmOOOOWWWWNNNN____PPPPOOOOSSSSSSSSIIIIBBBBLLLLEEEE____MMMMUUUULLLLTTTTIIIIPPPPLLLLEEEE Only takes ownership if more than one element can be selected at a time. XXXXmmmmNNNNrrrreeeennnnddddeeeerrrrTTTTaaaabbbblllleeee Specifies the XXXXmmmmRRRReeeennnnddddeeeerrrrTTTTaaaabbbblllleeee that is inherited by all children of the Container. The default is implementation dependent. If both a render table and a fontlist are specified, the render table will take precedence. XXXXmmmmNNNNsssseeeelllleeeeccccttttCCCCoooolllloooorrrr Specifies a Pixel that can be accessed by children of the Container and used to indicate that the child is in a selected state. In addition to a Pixel value, the following symbolic values can be specified: XXXXmmmmDDDDEEEEFFFFAAAAUUUULLLLTTTT____SSSSEEEELLLLEEEECCCCTTTT____CCCCOOOOLLLLOOOORRRR Specifies a color between the background and the bottom shadow color. XXXXmmmmRRRREEEEVVVVEEEERRRRSSSSEEEEDDDD____GGGGRRRROOOOUUUUNNNNDDDD____CCCCOOOOLLLLOOOORRRRSSSS Forces the select color to the foreground color and causes the default color of any text rendered over the select color to be the background color. _H_I_G_H_L_I_G_H_T__C_O_L_O_R Forces the fill color to use the highlight color. XXXXmmmmNNNNsssseeeelllleeeecccctttteeeeddddOOOObbbbjjjjeeeeccccttttCCCCoooouuuunnnntttt Specifies the number of widgets in the selected items list. The value must be the number of items Page 12 (printed 10/3/02) XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX)))) in XXXXmmmmNNNNsssseeeelllleeeecccctttteeeeddddOOOObbbbjjjjeeeeccccttttssss. XXXXmmmmNNNNsssseeeelllleeeecccctttteeeeddddOOOObbbbjjjjeeeeccccttttssss An array of widgets that represents the Container items that are currently selected, either by the user or by the application. If the application sets XXXXmmmmNNNNsssseeeelllleeeecccctttteeeeddddOOOObbbbjjjjeeeeccccttttssss to an array of widgets, those array elements that are valid Container items are selected. XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk Specifies a list of callbacks to call when an item is selected. The callback structure is XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrrSSSSeeeelllleeeeccccttttCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt. The reason is XXXXmmmmCCCCRRRR____SSSSIIIINNNNGGGGLLLLEEEE____SSSSEEEELLLLEEEECCCCTTTT, XXXXmmmmCCCCRRRR____BBBBRRRROOOOWWWWSSSSEEEE____SSSSEEEELLLLEEEECCCCTTTT, XXXXmmmmCCCCRRRR____MMMMUUUULLLLTTTTIIIIPPPPLLLLEEEE____SSSSEEEELLLLEEEECCCCTTTT, or XXXXmmmmCCCCRRRR____EEEEXXXXTTTTEEEENNNNDDDDEEEEDDDD____MMMMUUUULLLLTTTTIIIIPPPPLLLLEEEE, depending on XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy. XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy Defines the interpretation of the selection action. This can be one of the following values: XXXXmmmmSSSSIIIINNNNGGGGLLLLEEEE____SSSSEEEELLLLEEEECCCCTTTT Allows only single selections. XXXXmmmmBBBBRRRROOOOWWWWSSSSEEEE____SSSSEEEELLLLEEEECCCCTTTT Allows "drag and browse" selections. XXXXmmmmMMMMUUUULLLLTTTTIIIIPPPPLLLLEEEE____SSSSEEEELLLLEEEECCCCTTTT Allows multiple selections. XXXXmmmmEEEEXXXXTTTTEEEENNNNDDDDEEEEDDDD____SSSSEEEELLLLEEEECCCCTTTT Allows extended selections. XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnTTTTeeeecccchhhhnnnniiiiqqqquuuueeee Specifies the selection technique to use when the Container displays items in a 2-dimensional layout (XXXXmmmmNNNNeeeennnnttttrrrryyyyVVVViiiieeeewwwwTTTTyyyyppppeeee is XXXXmmmmLLLLAAAARRRRGGGGEEEE____IIIICCCCOOOONNNN or XXXXmmmmSSSSMMMMAAAALLLLLLLL____IIIICCCCOOOONNNN). In the XXXXmmmmDDDDEEEETTTTAAAAIIIILLLL layout, the XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnTTTTeeeecccchhhhnnnniiiiqqqquuuueeeeresource is treated as XXXXmmmmTTTTOOOOUUUUCCCCHHHH____OOOONNNNLLLLYYYY. In either case, it can have one of the following values: XXXXmmmmMMMMAAAARRRRQQQQUUUUEEEEEEEE Uses the Marquee technique only. XXXXmmmmMMMMAAAARRRRQQQQUUUUEEEEEEEE____EEEEXXXXTTTTEEEENNNNDDDD____SSSSTTTTAAAARRRRTTTT Uses the Marquee technique only and extends the Marquee rectangle around any item under the Marquee start point. XXXXmmmmMMMMAAAARRRRQQQQUUUUEEEEEEEE____EEEEXXXXTTTTEEEENNNNDDDD____BBBBOOOOTTTTHHHH Page 13 (printed 10/3/02) XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX)))) Uses the Marquee technique only and extends the Marquee rectangle around any items under the Marquee start and end points. XXXXmmmmTTTTOOOOUUUUCCCCHHHH____OOOONNNNLLLLYYYY Uses the Random-Swipe technique only if XXXXmmmmNNNNllllaaaayyyyoooouuuuttttTTTTyyyyppppeeee is XXXXmmmmSSSSPPPPAAAATTTTIIIIAAAALLLL. Otherwise, uses the Range-Swipe and Range-Click techniques. XXXXmmmmTTTTOOOOUUUUCCCCHHHH____OOOOVVVVEEEERRRR If the selection action begins over an item and XXXXmmmmNNNNllllaaaayyyyoooouuuuttttTTTTyyyyppppeeee is XXXXmmmmSSSSPPPPAAAATTTTIIIIAAAALLLL, uses the Random-Swipe technique. If the selection action begins over an item and XXXXmmmmNNNNllllaaaayyyyoooouuuuttttTTTTyyyyppppeeee is XXXXmmmmOOOOUUUUTTTTLLLLIIIINNNNEEEE or XXXXmmmmDDDDEEEETTTTAAAAIIIILLLL, uses the Range-Swipe and Range-Click techniques. Uses the Marquee technique if the select action begins over an unoccupied area in the Container. XXXXmmmmNNNNssssmmmmaaaallllllllCCCCeeeellllllllHHHHeeeeiiiigggghhhhtttt Specifies the height of a cell for XXXXmmmmGGGGRRRRIIIIDDDD or XXXXmmmmCCCCEEEELLLLLLLLSSSS spatial style when XXXXmmmmNNNNeeeennnnttttrrrryyyyVVVViiiieeeewwwwTTTTyyyyppppeeee is XXXXmmmmSSSSMMMMAAAALLLLLLLL____IIIICCCCOOOONNNN. XXXXmmmmNNNNssssmmmmaaaallllllllCCCCeeeellllllllWWWWiiiiddddtttthhhh Specifies the width of a cell for XXXXmmmmGGGGRRRRIIIIDDDD or XXXXmmmmCCCCEEEELLLLLLLLSSSS spatial style when XXXXmmmmNNNNeeeennnnttttrrrryyyyVVVViiiieeeewwwwTTTTyyyyppppeeee is XXXXmmmmSSSSMMMMAAAALLLLLLLL____IIIICCCCOOOONNNN. XXXXmmmmNNNNssssppppaaaattttiiiiaaaallllIIIInnnncccclllluuuuddddeeeeMMMMooooddddeeeellll Specifies the layout of an item when the item is managed in the Container when XXXXmmmmNNNNllllaaaayyyyoooouuuuttttTTTTyyyyppppeeee is XXXXmmmmSSSSPPPPAAAATTTTIIIIAAAALLLL and XXXXmmmmNNNNssssppppaaaattttiiiiaaaallllSSSSttttyyyylllleeee is XXXXmmmmGGGGRRRRIIIIDDDD or XXXXmmmmCCCCEEEELLLLLLLLSSSS. It can have one of the following values: XXXXmmmmAAAAPPPPPPPPEEEENNNNDDDD Places the item after the last occupied cell according to XXXXmmmmNNNNllllaaaayyyyoooouuuuttttDDDDiiiirrrreeeeccccttttiiiioooonnnn. XXXXmmmmCCCCLLLLOOOOSSSSEEEESSSSTTTT Places the item in the free cell closest to the position specified by XXXXmmmmNNNNxxxx and XXXXmmmmNNNNyyyy. XXXXmmmmFFFFIIIIRRRRSSSSTTTT____FFFFIIIITTTT Places the item in the first free cell according to XXXXmmmmNNNNllllaaaayyyyoooouuuuttttDDDDiiiirrrreeeeccccttttiiiioooonnnn. XXXXmmmmNNNNssssppppaaaattttiiiiaaaallllRRRReeeessssiiiizzzzeeeeMMMMooooddddeeeellll Specifies how Container will attempt to grow its dimensions when XXXXmmmmNNNNllllaaaayyyyoooouuuuttttTTTTyyyyppppeeee is XXXXmmmmSSSSPPPPAAAATTTTIIIIAAAALLLL and Page 14 (printed 10/3/02) XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX)))) XXXXmmmmNNNNssssppppaaaattttiiiiaaaallllSSSSttttyyyylllleeee is XXXXmmmmGGGGRRRRIIIIDDDD or XXXXmmmmCCCCEEEELLLLLLLLSSSSand there are not enough cells to contain a new Container item. It can have one of the following values: XXXXmmmmGGGGRRRROOOOWWWW____BBBBAAAALLLLAAAANNNNCCCCEEEEDDDD Container will request both width and height growth from its parent. XXXXmmmmGGGGRRRROOOOWWWW____MMMMAAAAJJJJOOOORRRR Container will request growth in its major dimension from its parent. Container's major dimension is width when the precedence of XXXXmmmmNNNNllllaaaayyyyoooouuuuttttDDDDiiiirrrreeeeccccttttiiiioooonnnn is horizontal, and height when vertical. XXXXmmmmGGGGRRRROOOOWWWW____MMMMIIIINNNNOOOORRRR Container will request growth in its minor dimension from its parent. Container's minor dimension is height when the precedence of XXXXmmmmNNNNllllaaaayyyyoooouuuuttttDDDDiiiirrrreeeeccccttttiiiioooonnnn is horizontal, and width when vertical. XXXXmmmmNNNNssssppppaaaattttiiiiaaaallllSSSSnnnnaaaappppMMMMooooddddeeeellll Specifies how Container will position an item within the cell layout when XXXXmmmmNNNNllllaaaayyyyoooouuuuttttTTTTyyyyppppeeee is XXXXmmmmSSSSPPPPAAAATTTTIIIIAAAALLLL and XXXXmmmmNNNNssssppppaaaattttiiiiaaaallllSSSSttttyyyylllleeee is XXXXmmmmGGGGRRRRIIIIDDDD or XXXXmmmmCCCCEEEELLLLLLLLSSSS. It can have one of the following values: XXXXmmmmCCCCEEEENNNNTTTTEEEERRRR Center the items as follows, depending on the value of XXXXmmmmNNNNeeeennnnttttrrrryyyyVVVViiiieeeewwwwTTTTyyyyppppeeee: XXXXmmmmLLLLAAAARRRRGGGGEEEE____IIIICCCCOOOONNNN The child is centered in the cell horizontally and baseline-aligned vertically. XXXXmmmmSSSSMMMMAAAALLLLLLLL____IIIICCCCOOOONNNN The child is centered in the cell vertically on its baseline and aligned with the left or right of the cell horizontally, depending on the value of XXXXmmmmNNNNllllaaaayyyyoooouuuuttttDDDDiiiirrrreeeeccccttttiiiioooonnnn. XXXXmmmmSSSSNNNNAAAAPPPP____TTTTOOOO____GGGGRRRRIIIIDDDD Position the item at the upper-left or upper-right corner of the cell(s), depending on the value of XXXXmmmmNNNNllllaaaayyyyoooouuuuttttDDDDiiiirrrreeeeccccttttiiiioooonnnn. Page 15 (printed 10/3/02) XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX)))) XXXXmmmmNNNNOOOONNNNEEEE Position the item according to the position specified by XXXXmmmmNNNNxxxx and XXXXmmmmNNNNyyyy. If the position is not within the coordinates of the cell(s), then position the item at the upper-left or upper-right corner of the cell(s), depending on the value of XXXXmmmmNNNNllllaaaayyyyoooouuuuttttDDDDiiiirrrreeeeccccttttiiiioooonnnn. XXXXmmmmNNNNssssppppaaaattttiiiiaaaallllSSSSttttyyyylllleeee Specifies the layout of Container items when XXXXmmmmNNNNllllaaaayyyyoooouuuuttttTTTTyyyyppppeeee is XXXXmmmmSSSSPPPPAAAATTTTIIIIAAAALLLL. It can have one of the following values: XXXXmmmmCCCCEEEELLLLLLLLSSSS Lays out items within a grid of same- size cells. Each item occupies as many cells as required to contain the item dimensions. XXXXmmmmGGGGRRRRIIIIDDDD Lays out items within a grid of same- size cells. Each item occupies only one cell. Items that are larger than the cell size may overlap other items. XXXXmmmmNNNNOOOONNNNEEEE Lays out items according to XXXXmmmmNNNNxxxx and XXXXmmmmNNNNyyyy. XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr CCCCoooonnnnssssttttrrrraaaaiiiinnnntttt RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt NNNNaaaammmmeeee CCCCllllaaaassssssss TTTTyyyyppppeeee DDDDeeeeffffaaaauuuulllltttt AAAAcccccccceeeessssssss XmNentryParent XmCWidget Widget NULL CSG XmNoutlineState XmCOutlineState unsigned char XmCOLLAPSED CSG XmNpositionIndex XmCPositionIndex int dynamic CSG XXXXmmmmNNNNeeeennnnttttrrrryyyyPPPPaaaarrrreeeennnntttt Specifies the widget that is this item's logical parent. A value of NULL indicates that this is a root-level item. Parent-child information is displayed only when the _X_m_N_l_a_y_o_u_t_P_o_l_i_c_y is XXXXmmmmOOOOUUUUTTTTLLLLIIIINNNNEEEEor XXXXmmmmDDDDEEEETTTTAAAAIIIILLLL. XXXXmmmmNNNNoooouuuuttttlllliiiinnnneeeeSSSSttttaaaatttteeee Specifies whether to display child items when _X_m_N_l_a_y_o_u_t_P_o_l_i_c_y is XXXXmmmmOOOOUUUUTTTTLLLLIIIINNNNEEEE or XXXXmmmmDDDDEEEETTTTAAAAIIIILLLL. It can have one of the following values: XXXXmmmmCCCCOOOOLLLLLLLLAAAAPPPPSSSSEEEEDDDD Does not display child items. XXXXmmmmEEEEXXXXPPPPAAAANNNNDDDDEEEEDDDD Displays child items. XXXXmmmmNNNNppppoooossssiiiittttiiiioooonnnnIIIInnnnddddeeeexxxx Page 16 (printed 10/3/02) XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX)))) Specifies the order of items in the Container for display. When XXXXmmmmNNNNllllaaaayyyyoooouuuuttttTTTTyyyyppppeeee is XXXXmmmmOOOOUUUUTTTTLLLLIIIINNNNEEEE or XXXXmmmmDDDDEEEETTTTAAAAIIIILLLL, items are displayed in XXXXmmmmNNNNppppoooossssiiiittttiiiioooonnnnIIIInnnnddddeeeexxxx order within XXXXmmmmNNNNeeeennnnttttrrrryyyyPPPPaaaarrrreeeennnntttt. Items that have an XXXXmmmmNNNNeeeennnnttttrrrryyyyPPPPaaaarrrreeeennnntttt resource are ignored when XXXXmmmmNNNNllllaaaayyyyoooouuuuttttTTTTyyyyppppeeee is XXXXmmmmSSSSPPPPAAAATTTTIIIIAAAALLLL. If XXXXmmmmNNNNppppoooossssiiiittttiiiioooonnnnIIIInnnnddddeeeexxxx is not specified, it defaults to the XXXXmmmmNNNNppppoooossssiiiittttiiiioooonnnnIIIInnnnddddeeeexxxx value plus 1 of the item with the highest XXXXmmmmNNNNppppoooossssiiiittttiiiioooonnnnIIIInnnnddddeeeexxxx that has the same XXXXmmmmNNNNeeeennnnttttrrrryyyyPPPPaaaarrrreeeennnntttt if such an item exists; otherwise, it defaults to 0. IIIInnnnhhhheeeerrrriiiitttteeeedddd RRRReeeessssoooouuuurrrrcccceeeessss Container inherits behavior and resources from the superclasses described in the following tables. For a complete description of each resource, refer to the reference page for that superclass. XXXXmmmmMMMMaaaannnnaaaaggggeeeerrrr RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt NNNNaaaammmmeeee CCCCllllaaaassssssss TTTTyyyyppppeeee DDDDeeeeffffaaaauuuulllltttt AAAAcccccccceeeessssssss XmNbottomShadowColor XmCBottomShadowColor Pixel dynamic CSG XmNbottomShadowPixmap XmCBottomShadowPixmap Pixmap XmUNSPECIFIED_PIXMAP CSG XmNforeground XmCForeground Pixel dynamic CSG XmNhelpCallback XmCCallback XtCallbackList NULL C XmNhighlightColor XmCHighlightColor Pixel dynamic CSG XmNhighlightPixmap XmCHighlightPixmap Pixmap dynamic CSG XmNinitialFocus XmCInitialFocus Widget NULL CSG XmNlayoutDirection XmCLayoutDirection XmDirection dynamic CG XmNnavigationType XmCNavigationType XmNavigationType XmTAB_GROUP CSG XmNpopupHandlerCallback XmCCallback XtCallbackList NULL C XmNshadowThickness XmCShadowThickness Dimension 0 CSG XmNstringDirection XmCStringDirection XmStringDirection dynamic CG XmNtopShadowColor XmCTopShadowColor Pixel dynamic CSG XmNtopShadowPixmap XmCTopShadowPixmap Pixmap dynamic CSG XmNtraversalOn XmCTraversalOn Boolean True CSG XmNunitType XmCUnitType unsigned char dynamic CSG XmNuserData XmCUserData XtPointer NULL CSG CCCCoooommmmppppoooossssiiiitttteeee RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt NNNNaaaammmmeeee CCCCllllaaaassssssss TTTTyyyyppppeeee DDDDeeeeffffaaaauuuulllltttt AAAAcccccccceeeessssssss XmNchildren XmCReadOnly WidgetList NULL G XmNinsertPosition XmCInsertPosition XtOrderProc NULL CSG XmNnumChildren XmCReadOnly Cardinal 0 G CCCCoooorrrreeee RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt NNNNaaaammmmeeee CCCCllllaaaassssssss TTTTyyyyppppeeee DDDDeeeeffffaaaauuuulllltttt AAAAcccccccceeeessssssss XmNaccelerators XmCAccelerators XtAccelerators dynamic CSG XmNancestorSensitive XmCSensitive Boolean dynamic G XmNbackground XmCBackground Pixel dynamic CSG XmNbackgroundPixmap XmCPixmap Pixmap XmUNSPECIFIED_PIXMAP CSG XmNborderColor XmCBorderColor Pixel XtDefaultForeground CSG Page 17 (printed 10/3/02) XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX)))) XmNborderPixmap XmCPixmap Pixmap XmUNSPECIFIED_PIXMAP CSG XmNborderWidth XmCBorderWidth Dimension 0 CSG XmNcolormap XmCColormap Colormap dynamic CG XmNdepth XmCDepth int dynamic CG XmNdestroyCallback XmCCallback XtCallbackList NULL C XmNheight XmCHeight Dimension dynamic CSG XmNinitialResourcesPersistent XmCInitialResourcesPersistent Boolean True C XmNmappedWhenManaged XmCMappedWhenManaged Boolean True CSG XmNscreen XmCScreen Screen * dynamic CG XmNsensitive XmCSensitive Boolean True CSG XmNtranslations XmCTranslations XtTranslations dynamic CSG XmNwidth XmCWidth Dimension dynamic CSG XmNx XmCPosition Position 0 CSG XmNy XmCPosition Position 0 CSG CCCCaaaallllllllbbbbaaaacccckkkk IIIInnnnffffoooorrrrmmmmaaaattttiiiioooonnnn A pointer to the following structure is passed to callbacks for XXXXmmmmNNNNoooouuuuttttlllliiiinnnneeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkk. typedef struct { int _r_e_a_s_o_n; XEvent * _e_v_e_n_t; Widget _i_t_e_m; unsigned char _n_e_w__o_u_t_l_i_n_e__s_t_a_t_e; } XmContainerOutlineCallbackStruct; _r_e_a_s_o_n Specifies the reason for the callback. _e_v_e_n_t Points to the _X_E_v_e_n_t that triggered the callback. It can be NULL. _i_t_e_m Specifies the container item affected by the event. _n_e_w__o_u_t_l_i_n_e__s_t_a_t_e Specifies the next XXXXmmmmNNNNoooouuuuttttlllliiiinnnneeeeSSSSttttaaaatttteeee for _i_t_e_m. The user can change this value in the callback. A pointer to the following structure is passed to callbacks for XXXXmmmmNNNNddddeeeeffffaaaauuuullllttttAAAAccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk and XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk. typedef struct { int _r_e_a_s_o_n; XEvent * _e_v_e_n_t; WidgetList _s_e_l_e_c_t_e_d__i_t_e_m_s; int _s_e_l_e_c_t_e_d__i_t_e_m__c_o_u_n_t; unsigned char _a_u_t_o__s_e_l_e_c_t_i_o_n__t_y_p_e; } XmContainerSelectCallbackStruct; _r_e_a_s_o_n Specifies the reason for the callback. It Page 18 (printed 10/3/02) XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX)))) corresponds to the XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy at the time the selection was made, or indicates that the default action should be taken. _e_v_e_n_t Points to the _X_E_v_e_n_t that triggered the callback. It can be NULL. _s_e_l_e_c_t_e_d__i_t_e_m_s Specifies a list of items selected at the time of the _e_v_e_n_t that caused the callback. The _s_e_l_e_c_t_e_d__i_t_e_m_s field points to a temporary storage space that is reused after the callback is finished. Therefore, if an application needs to save the selected list, it should copy the list into its own data space. _s_e_l_e_c_t_e_d__i_t_e_m__c_o_u_n_t Specifies the number of items in the _s_e_l_e_c_t_e_d__i_t_e_m_s list. This number must be positive or 0 (zero). aaaauuuuttttoooo____sssseeeelllleeeeccccttttiiiioooonnnn____ttttyyyyppppeeee Indicates the cause of the selection when XXXXmmmmNNNNaaaauuuuttttoooommmmaaaattttiiiiccccSSSSeeeelllleeeeccccttttiiiioooonnnn is XXXXmmmmAAAAUUUUTTTTOOOO____SSSSEEEELLLLEEEECCCCTTTT. Valid values are the following: XXXXmmmmAAAAUUUUTTTTOOOO____UUUUNNNNSSSSEEEETTTT Returned when XXXXmmmmNNNNaaaauuuuttttoooommmmaaaattttiiiiccccSSSSeeeelllleeeeccccttttiiiioooonnnn is XXXXmmmmNNNNOOOO____AAAAUUUUTTTTOOOO____SSSSEEEELLLLEEEECCCCTTTT. XXXXmmmmAAAAUUUUTTTTOOOO____BBBBEEEEGGGGIIIINNNN Indicates the beginning of automatic selection. XXXXmmmmAAAAUUUUTTTTOOOO____MMMMOOOOTTTTIIIIOOOONNNN Indicates that there is a button drag selection. XXXXmmmmAAAAUUUUTTTTOOOO____CCCCAAAANNNNCCCCEEEELLLL Indicates that the new selection is canceled. XXXXmmmmAAAAUUUUTTTTOOOO____NNNNOOOO____CCCCHHHHAAAANNNNGGGGEEEE Indicates that the currently selected item matches the initial item. XXXXmmmmAAAAUUUUTTTTOOOO____CCCCHHHHAAAANNNNGGGGEEEE Indicates that the currently selected item does not match the initial item. A pointer to the following structure is passed to the XXXXmmmmNNNNccccoooonnnnvvvveeeerrrrttttCCCCaaaallllllllbbbbaaaacccckkkk procedures: Page 19 (printed 10/3/02) XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX)))) typedef struct { int _r_e_a_s_o_n; XEvent *_e_v_e_n_t; Atom _s_e_l_e_c_t_i_o_n; Atom _t_a_r_g_e_t; XtPointer _s_o_u_r_c_e__d_a_t_a; XtPointer _l_o_c_a_t_i_o_n__d_a_t_a; int _f_l_a_g_s; XtPointer _p_a_r_m; int _p_a_r_m__f_o_r_m_a_t; unsigned long _p_a_r_m__l_e_n_g_t_h; int _s_t_a_t_u_s; XtPointer _v_a_l_u_e; Atom _t_y_p_e; int _f_o_r_m_a_t; unsigned long _l_e_n_g_t_h; } XmConvertCallbackStruct; _r_e_a_s_o_n Indicates why the callback was invoked. _e_v_e_n_t Points to the _X_E_v_e_n_t that triggered the callback. It can be NULL. _s_e_l_e_c_t_i_o_n Indicates the selection for which conversion is being requested. Possible values are _C_L_I_P_B_O_A_R_D, _P_R_I_M_A_R_Y, _S_E_C_O_N_D_A_R_Y, and ____MMMMOOOOTTTTIIIIFFFF____DDDDRRRROOOOPPPP. _t_a_r_g_e_t Indicates the conversion target. _s_o_u_r_c_e__d_a_t_a Contains information about the selection source. When the selection is ____MMMMOOOOTTTTIIIIFFFF____DDDDRRRROOOOPPPP, _s_o_u_r_c_e__d_a_t_a is the DragContext. Otherwise, it is NULL. llllooooccccaaaattttiiiioooonnnn____ddddaaaattttaaaa Contains information about the location of data to be converted. If the value is NULL, the data to be transferred consists of the widget's current selection. Otherwise, it is the widget ID of the item being transferred, or the widget ID of the Container if all items are being transferred. _f_l_a_g_s Indicates the status of the conversion. Following are the possible values: XXXXmmmmCCCCOOOONNNNVVVVEEEERRRRTTTTIIIINNNNGGGG____NNNNOOOONNNNEEEE This flag is currently unused. XXXXmmmmCCCCOOOONNNNVVVVEEEERRRRTTTTIIIINNNNGGGG____PPPPAAAARRRRTTTTIIIIAAAALLLL The target widget was able to be converted, but some data was lost. Page 20 (printed 10/3/02) XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX)))) XXXXmmmmCCCCOOOONNNNVVVVEEEERRRRTTTTIIIINNNNGGGG____SSSSAAAAMMMMEEEE The conversion target is the source of the data to be transferred. XXXXmmmmCCCCOOOONNNNVVVVEEEERRRRTTTTIIIINNNNGGGG____TTTTRRRRAAAANNNNSSSSAAAACCCCTTTT This flag is currently unused. _p_a_r_m Contains parameter data for this target. If no parameter data exists, the value is NULL. When _s_e_l_e_c_t_i_o_n is _C_L_I_P_B_O_A_R_D and _t_a_r_g_e_t is ____MMMMOOOOTTTTIIIIFFFF____CCCCLLLLIIIIPPPPBBBBOOOOAAAARRRRDDDD____TTTTAAAARRRRGGGGEEEETTTTSSSS or ____MMMMOOOOTTTTIIIIFFFF____DDDDEEEEFFFFEEEERRRRRRRREEEEDDDD____CCCCLLLLIIIIPPPPBBBBOOOOAAAARRRRDDDD____TTTTAAAARRRRGGGGEEEETTTTSSSS, the value is the requested operation (XXXXmmmmCCCCOOOOPPPPYYYY, XXXXmmmmMMMMOOOOVVVVEEEE, or XXXXmmmmLLLLIIIINNNNKKKK). _p_a_r_m__f_o_r_m_a_t Specifies whether the data in _p_a_r_m should be viewed as a list of _c_h_a_r, _s_h_o_r_t, or _l_o_n_g quantities. Possible values are 0 (when _p_a_r_m is NULL), 8 (when the data in _p_a_r_m should be viewed as a list of _c_h_a_rs), 16 (when the data in _p_a_r_m should be viewed as a list of _s_h_o_r_ts), or 32 (when the data in _p_a_r_m should be viewed as a list of _l_o_n_gs). Note that _p_a_r_m__f_o_r_m_a_t symbolizes a data type, not the number of bits in each list element. For example, on some machines, a _p_a_r_m__f_o_r_m_a_t of 32 means that the data in _p_a_r_m should be viewed as a list of 64-bit quantities, not 32-bit quantities. _p_a_r_m__l_e_n_g_t_h Specifies the number of elements of data in _p_a_r_m, where each element has the size specified by _p_a_r_m__f_o_r_m_a_t. When _p_a_r_m is NULL, the value is 0. _s_t_a_t_u_s An IN/OUT member that specifies the status of the conversion. The initial value is XXXXmmmmCCCCOOOONNNNVVVVEEEERRRRTTTT____DDDDEEEEFFFFAAAAUUUULLLLTTTT. The callback procedure can set this member to one of the following values: XXXXmmmmCCCCOOOONNNNVVVVEEEERRRRTTTT____DDDDEEEEFFFFAAAAUUUULLLLTTTT The widget class conversion procedure, if any, is called after the callback procedures return. If the widget class conversion procedure produces any data, it overwrites the data provided by the callback procedures in the _v_a_l_u_emember. XXXXmmmmCCCCOOOONNNNVVVVEEEERRRRTTTT____MMMMEEEERRRRGGGGEEEE The widget class conversion procedure, if any, is called after the callback procedures return. If the widget class Page 21 (printed 10/3/02) XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX)))) conversion procedure produces any data, it appends its data to the data provided by the callback procedures in the _v_a_l_u_e member. This value is intended for use with targets that result in lists of data, such as _T_A_R_G_E_T_S. XXXXmmmmCCCCOOOONNNNVVVVEEEERRRRTTTT____DDDDOOOONNNNEEEE The callback procedure has successfully finished the conversion. The widget class conversion procedure, if any, is not called after the callback procedures return. XXXXmmmmCCCCOOOONNNNVVVVEEEERRRRTTTT____RRRREEEEFFFFUUUUSSSSEEEE The callback procedure has terminated the conversion process without completing the requested conversion. The widget class conversion procedure, if any, is not called after the callback procedures return. _v_a_l_u_e An IN/OUT parameter that contains any data that the callback procedure produces as a result of the conversion. The initial value is NULL. If the callback procedure sets this member, it must ensure that the _t_y_p_e, _f_o_r_m_a_t, and _l_e_n_g_t_h members correspond to the data in _v_a_l_u_e. The callback procedure is responsible for allocating, but not for freeing, memory when it sets this member. _t_y_p_e An IN/OUT parameter that indicates the type of the data in the _v_a_l_u_e member. The initial value is _I_N_T_E_G_E_R. _f_o_r_m_a_t An IN/OUT parameter that specifies whether the data in _v_a_l_u_e should be viewed as a list of _c_h_a_r, _s_h_o_r_t, or _l_o_n_g quantities. The initial value is 8. The callback procedure can set this member to 8 (for a list of _c_h_a_r), 16 (for a list of _s_h_o_r_t), or 32 (for a list of _l_o_n_g). _l_e_n_g_t_h An IN/OUT member that specifies the number of elements of data in _v_a_l_u_e, where each element has the size symbolized by _f_o_r_m_a_t. The initial value is 0 (zero). A pointer to the following callback structure is passed to the XXXXmmmmNNNNddddeeeessssttttiiiinnnnaaaattttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk procedures: typedef struct { Page 22 (printed 10/3/02) XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX)))) int _r_e_a_s_o_n; XEvent *_e_v_e_n_t; Atom _s_e_l_e_c_t_i_o_n; XtEnum _o_p_e_r_a_t_i_o_n; int _f_l_a_g_s; XtPointer _t_r_a_n_s_f_e_r__i_d; XtPointer _d_e_s_t_i_n_a_t_i_o_n__d_a_t_a; XtPointer _l_o_c_a_t_i_o_n__d_a_t_a; Time _t_i_m_e; } XmDestinationCallbackStruct; _r_e_a_s_o_n Indicates why the callback was invoked. _e_v_e_n_t Points to the _X_E_v_e_n_t that triggered the callback. It can be NULL. _s_e_l_e_c_t_i_o_n Indicates the selection for which data transfer is being requested. Possible values are _C_L_I_P_B_O_A_R_D, _P_R_I_M_A_R_Y, _S_E_C_O_N_D_A_R_Y, and ____MMMMOOOOTTTTIIIIFFFF____DDDDRRRROOOOPPPP. _o_p_e_r_a_t_i_o_n Indicates the type of transfer operation requested. +o When the selection is _P_R_I_M_A_R_Y, possible values are XXXXmmmmMMMMOOOOVVVVEEEE, XXXXmmmmCCCCOOOOPPPPYYYY, and XXXXmmmmLLLLIIIINNNNKKKK. +o When the selection is _S_E_C_O_N_D_A_R_Y or _C_L_I_P_B_O_A_R_D, possible values are XXXXmmmmCCCCOOOOPPPPYYYY and XXXXmmmmLLLLIIIINNNNKKKK. +o When the selection is ____MMMMOOOOTTTTIIIIFFFF____DDDDRRRROOOOPPPP, possible values are XXXXmmmmMMMMOOOOVVVVEEEE, XXXXmmmmCCCCOOOOPPPPYYYY, XXXXmmmmLLLLIIIINNNNKKKK, and XXXXmmmmOOOOTTTTHHHHEEEERRRR. A value of XXXXmmmmOOOOTTTTHHHHEEEERRRR means that the callback procedure must get further information from the XXXXmmmmDDDDrrrrooooppppPPPPrrrrooooccccCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt in the _d_e_s_t_i_n_a_t_i_o_n__d_a_t_a member. _f_l_a_g_s Indicates whether or not the destination widget is also the source of the data to be transferred. Following are the possible values: XXXXmmmmCCCCOOOONNNNVVVVEEEERRRRTTTTIIIINNNNGGGG____NNNNOOOONNNNEEEE The destination widget is not the source of the data to be transferred. XXXXmmmmCCCCOOOONNNNVVVVEEEERRRRTTTTIIIINNNNGGGG____SSSSAAAAMMMMEEEE The destination widget is the source of the data to be transferred. ttttrrrraaaannnnssssffffeeeerrrr____iiiidddd Serves as a unique ID to identify the transfer Page 23 (printed 10/3/02) XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX)))) transaction. _d_e_s_t_i_n_a_t_i_o_n__d_a_t_a Contains information about the destination. When the selection is ____MMMMOOOOTTTTIIIIFFFF____DDDDRRRROOOOPPPP, the callback procedures are called by the drop site's XXXXmmmmNNNNddddrrrrooooppppPPPPrrrroooocccc, and _d_e_s_t_i_n_a_t_i_o_n__d_a_t_ais a pointer to the XXXXmmmmDDDDrrrrooooppppPPPPrrrrooooccccCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt passed to the XXXXmmmmNNNNddddrrrrooooppppPPPPrrrroooocccc procedure. When the selection is _S_E_C_O_N_D_A_R_Y, _d_e_s_t_i_n_a_t_i_o_n__d_a_t_a is an Atom representing a target recommmended by the selection owner for use in converting the selection. Otherwise, _d_e_s_t_i_n_a_t_i_o_n__d_a_t_a is NULL. llllooooccccaaaattttiiiioooonnnn____ddddaaaattttaaaa Contains information about the location where data is to be transferred. The value is always NULL when the selection is _S_E_C_O_N_D_A_R_Y or _C_L_I_P_B_O_A_R_D. If the value is NULL, the data is to be inserted at the widget's cursor position. Otherwise, the value is a pointer to an _X_P_o_i_n_t structure containing the x and y coordinates at the location where the data is to be transferred. Once _X_m_T_r_a_n_s_f_e_r_D_o_n_e procedures start to be called, llllooooccccaaaattttiiiioooonnnn____ddddaaaattttaaaa will no longer be stable. _t_i_m_e Indicates the time when the transfer operation began. TTTTrrrraaaannnnssssllllaaaattttiiiioooonnnnssss The XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr translations are listed below. The following key names are listed in the X standard key event translation table syntax. This format is the one used by Motif to specify the widget actions corresponding to a given key. A brief overview of the format is provided under VVVViiiirrrrttttuuuuaaaallllBBBBiiiinnnnddddiiiinnnnggggssss(3). For a complete description of the format, please refer to the X Toolkit Instrinsics Documentation. ~~~~cccc ~~~~ssss ~~~~mmmm ~~~~aaaa <<<<BBBBttttnnnn1111DDDDoooowwwwnnnn>>>>: ContainerBeginSelect() <<<<BBBBttttnnnn1111MMMMoooottttiiiioooonnnn>>>>: ContainerButtonMotion() ~~~~cccc ~~~~ssss ~~~~mmmm ~~~~aaaa <<<<BBBBttttnnnn1111UUUUpppp>>>>: ContainerEndSelect() cccc ~~~~ssss ~~~~mmmm ~~~~aaaa <<<<BBBBttttnnnn1111DDDDoooowwwwnnnn>>>>: ContainerBeginToggle() Page 24 (printed 10/3/02) XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX)))) cccc ~~~~ssss ~~~~mmmm ~~~~aaaa <<<<BBBBttttnnnn1111UUUUpppp>>>>: ContainerEndToggle() ~~~~cccc ssss ~~~~mmmm ~~~~aaaa <<<<BBBBttttnnnn1111DDDDoooowwwwnnnn>>>>: ContainerBeginExtend() ~~~~cccc ssss ~~~~mmmm ~~~~aaaa <<<<BBBBttttnnnn1111UUUUpppp>>>>: ContainerEndExtend() cccc ssss ~~~~mmmm ~~~~aaaa <<<<BBBBttttnnnn1111DDDDoooowwwwnnnn>>>>: ContainerBeginExtend() cccc ssss ~~~~mmmm ~~~~aaaa <<<<BBBBttttnnnn1111UUUUpppp>>>>: ContainerEndExtend() ~~~~cccc ~~~~ssss ~~~~mmmm ~~~~aaaa <<<<BBBBttttnnnn2222DDDDoooowwwwnnnn>>>>: ContainerStartTransfer(_C_o_p_y) cccc ssss ~~~~mmmm ~~~~aaaa <<<<BBBBttttnnnn2222DDDDoooowwwwnnnn>>>>: ContainerStartTransfer(_L_i_n_k) ~~~~cccc ssss ~~~~mmmm ~~~~aaaa <<<<BBBBttttnnnn2222DDDDoooowwwwnnnn>>>>: ContainerStartTransfer(_M_o_v_e) ~~~~mmmm ~~~~aaaa <<<<BBBBttttnnnn2222UUUUpppp>>>>: ContainerEndTransfer() ::::cccc ssss aaaa <<<<KKKKeeeeyyyy>>>><<<<oooossssffffIIIInnnnsssseeeerrrrtttt>>>>: ContainerPrimaryLink() ::::cccc ssss mmmm <<<<KKKKeeeeyyyy>>>><<<<oooossssffffIIIInnnnsssseeeerrrrtttt>>>>: ContainerPrimaryLink() ::::aaaa <<<<KKKKeeeeyyyy>>>><<<<oooossssffffIIIInnnnsssseeeerrrrtttt>>>>: ContainerPrimaryCopy() ::::mmmm <<<<KKKKeeeeyyyy>>>><<<<oooossssffffIIIInnnnsssseeeerrrrtttt>>>>: ContainerPrimaryCopy() ::::ssss aaaa <<<<KKKKeeeeyyyy>>>><<<<oooossssffffDDDDeeeelllleeeetttteeee>>>>: ContainerPrimaryMove() ::::ssss mmmm <<<<KKKKeeeeyyyy>>>><<<<oooossssffffDDDDeeeelllleeeetttteeee>>>>: ContainerPrimaryMove() ::::<<<<KKKKeeeeyyyy>>>><<<<oooossssffffCCCCaaaannnncccceeeellll>>>>: ContainerCancel() ::::ssss <<<<KKKKeeeeyyyy>>>><<<<oooossssffffSSSSeeeelllleeeecccctttt>>>>: ContainerExtend() ::::<<<<KKKKeeeeyyyy>>>><<<<oooossssffffSSSSeeeelllleeeecccctttt>>>>: Page 25 (printed 10/3/02) XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX)))) ContainerSelect() ::::<<<<KKKKeeeeyyyy>>>><<<<oooossssffffSSSSeeeelllleeeeccccttttAAAAllllllll>>>>: ContainerSelectAll() ::::<<<<KKKKeeeeyyyy>>>><<<<oooossssffffDDDDeeeesssseeeelllleeeeccccttttAAAAllllllll>>>>: ContainerDeselectAll() ::::<<<<KKKKeeeeyyyy>>>><<<<oooossssffffAAAAddddddddMMMMooooddddeeee>>>>: ContainerToggleMode() ::::<<<<KKKKeeeeyyyy>>>><<<<oooossssffffAAAAccccttttiiiivvvvaaaatttteeee>>>>: ContainerActivate() ssss ~~~~cccc ~~~~mmmm ~~~~aaaa <<<<KKKKeeeeyyyy>>>>ssssppppaaaacccceeee: ContainerExtend() ~~~~ssss ~~~~cccc ~~~~mmmm ~~~~aaaa <<<<KKKKeeeeyyyy>>>>ssssppppaaaacccceeee: ContainerSelect() ~~~~ssss ~~~~cccc ~~~~mmmm ~~~~aaaa <<<<KKKKeeeeyyyy>>>>RRRReeeettttuuuurrrrnnnn: ContainerActivate() ~~~~ssss cccc ~~~~mmmm ~~~~aaaa <<<<KKKKeeeeyyyy>>>>ssssllllaaaasssshhhh: ContainerSelectAll() ~~~~ssss cccc ~~~~mmmm ~~~~aaaa <<<<KKKKeeeeyyyy>>>>bbbbaaaacccckkkkssssllllaaaasssshhhh: ContainerDeselectAll() ::::cccc ssss <<<<KKKKeeeeyyyy>>>><<<<oooossssffffBBBBeeeeggggiiiinnnnLLLLiiiinnnneeee>>>>: ContainerExtendCursor(_F_i_r_s_t) ::::cccc ssss <<<<KKKKeeeeyyyy>>>><<<<oooossssffffEEEEnnnnddddLLLLiiiinnnneeee>>>>: ContainerExtendCursor(_L_a_s_t) ::::cccc <<<<KKKKeeeeyyyy>>>><<<<oooossssffffBBBBeeeeggggiiiinnnnLLLLiiiinnnneeee>>>>: ContainerMoveCursor(_F_i_r_s_t) ::::cccc <<<<KKKKeeeeyyyy>>>><<<<oooossssffffEEEEnnnnddddLLLLiiiinnnneeee>>>>: ContainerMoveCursor(_L_a_s_t) ::::cccc <<<<KKKKeeeeyyyy>>>><<<<oooossssffffLLLLeeeefffftttt>>>>: ContainerExpandOrCollapse(_L_e_f_t) ::::cccc <<<<KKKKeeeeyyyy>>>><<<<oooossssffffRRRRiiiigggghhhhtttt>>>>: ContainerExpandOrCollapse(_R_i_g_h_t) ::::ssss <<<<KKKKeeeeyyyy>>>><<<<oooossssffffUUUUpppp>>>>: ContainerExtendCursor(_U_p) ::::ssss <<<<KKKKeeeeyyyy>>>><<<<oooossssffffDDDDoooowwwwnnnn>>>>: ContainerExtendCursor(_D_o_w_n) Page 26 (printed 10/3/02) XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX)))) ::::ssss <<<<KKKKeeeeyyyy>>>><<<<oooossssffffLLLLeeeefffftttt>>>>: ContainerExtendCursor(_L_e_f_t) ::::ssss <<<<KKKKeeeeyyyy>>>><<<<oooossssffffRRRRiiiigggghhhhtttt>>>>: ContainerExtendCursor(_R_i_g_h_t) ::::<<<<KKKKeeeeyyyy>>>><<<<oooossssffffUUUUpppp>>>>: ContainerMoveCursor(_U_p) ::::<<<<KKKKeeeeyyyy>>>><<<<oooossssffffDDDDoooowwwwnnnn>>>>: ContainerMoveCursor(_D_o_w_n) ::::<<<<KKKKeeeeyyyy>>>><<<<oooossssffffLLLLeeeefffftttt>>>>: ContainerMoveCursor(_L_e_f_t) ::::<<<<KKKKeeeeyyyy>>>><<<<oooossssffffRRRRiiiigggghhhhtttt>>>>: ContainerMoveCursor(_R_i_g_h_t) ssss ~~~~mmmm ~~~~aaaa <<<<KKKKeeeeyyyy>>>>TTTTaaaabbbb: ManagerGadgetPrevTabGroup() ~~~~ssss ~~~~mmmm ~~~~aaaa <<<<KKKKeeeeyyyy>>>>TTTTaaaabbbb: ManagerGadgetNextTabGroup() The Container button event translations are modified when Display's XXXXmmmmNNNNeeeennnnaaaabbbblllleeeeBBBBttttnnnn1111TTTTrrrraaaannnnssssffffeeeerrrr resource does not have a value of XXXXmmmmOOOOFFFFFFFF (in other words, it is either _X_m_B_U_T_T_O_N_2__T_R_A_N_S_F_E_R or _X_m_B_U_T_T_O_N_2__A_D_J_U_S_T). This option allows the actions for selection and transfer to be integrated on <<<<BBBBttttnnnn1111>>>>, and the actions for extending the selection can be bound to <<<<BBBBttttnnnn2222>>>>. The actions for <<<<BBBBttttnnnn1111>>>> that are defined in the preceding list still apply when the <<<<BBBBttttnnnn1111>>>> event occurs over text that is not selected. The following actions apply when the <<<<BBBBttttnnnn1111>>>> event occurs over text that is selected: ~~~~cccc ~~~~ssss ~~~~mmmm ~~~~aaaa <<<<BBBBttttnnnn1111DDDDoooowwwwnnnn>>>>:::: ContainerHandleBtn1Down(_C_o_n_t_a_i_n_e_r_B_e_g_i_n_S_e_l_e_c_t,_C_o_p_y) cccc ~~~~ssss ~~~~mmmm ~~~~aaaa <<<<BBBBttttnnnn1111DDDDoooowwwwnnnn>>>>:::: ContainerHandleBtn1Down(_C_o_n_t_a_i_n_e_r_B_e_g_i_n_T_o_g_g_l_e,_C_o_p_y) cccc ssss ~~~~mmmm ~~~~aaaa <<<<BBBBttttnnnn1111DDDDoooowwwwnnnn>>>>:::: ContainerHandleBtn1Down(_C_o_n_t_a_i_n_e_r_N_o_o_p,_L_i_n_k) ~~~~cccc ssss ~~~~mmmm ~~~~aaaa <<<<BBBBttttnnnn1111DDDDoooowwwwnnnn>>>>:::: ContainerHandleBtn1Down(_C_o_n_t_a_i_n_e_r_B_e_g_i_n_E_x_t_e_n_d,_M_o_v_e) <<<<BBBBttttnnnn1111MMMMoooottttiiiioooonnnn>>>>:::: ContainerHandleBtn1Motion(_C_o_n_t_a_i_n_e_r_B_u_t_t_o_n_M_o_t_i_o_n) ~~~~cccc ~~~~ssss ~~~~mmmm ~~~~aaaa <<<<BBBBttttnnnn1111UUUUpppp>>>>:::: ContainerHandleBtn1Up(_C_o_n_t_a_i_n_e_r_E_n_d_S_e_l_e_c_t) Page 27 (printed 10/3/02) XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX)))) cccc ~~~~ssss ~~~~mmmm ~~~~aaaa <<<<BBBBttttnnnn1111UUUUpppp>>>>:::: ContainerHandleBtn1Up(_C_o_n_t_a_i_n_e_r_E_n_d_T_o_g_g_l_e) ~~~~cccc ssss ~~~~mmmm ~~~~aaaa <<<<BBBBttttnnnn1111UUUUpppp>>>>:::: ContainerHandleBtn1Up(_C_o_n_t_a_i_n_e_r_E_n_d_E_x_t_e_n_d) cccc ssss ~~~~mmmm ~~~~aaaa <<<<BBBBttttnnnn1111DDDDoooowwwwnnnn>>>>:::: ContainerHandleBtn1Down(_C_o_n_t_a_i_n_e_r_B_e_g_i_n_E_x_t_e_n_d) cccc ssss ~~~~mmmm ~~~~aaaa <<<<BBBBttttnnnn1111UUUUpppp>>>>:::: ContainerHandleBtn1Up(_C_o_n_t_a_i_n_e_r_E_n_d_E_x_t_e_n_d) When Display's XXXXmmmmNNNNeeeennnnaaaabbbblllleeeeBBBBttttnnnn1111TTTTrrrraaaannnnssssffffeeeerrrr resource has a value of _X_m_B_U_T_T_O_N_2__A_D_J_U_S_T, the following actions apply: ~~~~cccc ~~~~ssss ~~~~mmmm ~~~~aaaa <<<<BBBBttttnnnn2222DDDDoooowwwwnnnn>>>>:::: ContainerHandleBtn2Down(_C_o_n_t_a_i_n_e_r_S_t_a_r_t_T_r_a_n_s_f_e_r,_C_o_p_y) cccc ssss ~~~~mmmm ~~~~aaaa <<<<BBBBttttnnnn2222DDDDoooowwwwnnnn>>>>:::: ContainerHandleBtn2Down(_C_o_n_t_a_i_n_e_r_S_t_a_r_t_T_r_a_n_s_f_e_r,_L_i_n_k) ~~~~cccc ssss ~~~~mmmm ~~~~aaaa <<<<BBBBttttnnnn2222DDDDoooowwwwnnnn>>>>:::: ContainerHandleBtn2Down(_C_o_n_t_a_i_n_e_r_S_t_a_r_t_T_r_a_n_s_f_e_r,_M_o_v_e) <<<<BBBBttttnnnn2222MMMMoooottttiiiioooonnnn>>>>:::: ContainerHandleBtn2Motion(_C_o_n_t_a_i_n_e_r_B_u_t_t_o_n_M_o_t_i_o_n) ~~~~mmmm ~~~~aaaa <<<<BBBBttttnnnn2222UUUUpppp>>>>:::: ContainerHandleBtn2Up(_C_o_n_t_a_i_n_e_r_E_n_d_T_r_a_n_s_f_e_r) AAAAccccttttiiiioooonnnn RRRRoooouuuuttttiiiinnnneeeessss The Container action routines are described below. The current selections are always shown with the background color specified by the XXXXmmmmNNNNsssseeeelllleeeeccccttttCCCCoooolllloooorrrr resource. ContainerActivate(): This action calls XXXXmmmmNNNNddddeeeeffffaaaauuuullllttttAAAAccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkkwith reason XXXXmmmmCCCCRRRR____DDDDEEEEFFFFAAAAUUUULLLLTTTT____AAAACCCCTTTTIIIIOOOONNNN. ContainerBeginExtend(): Simply returns if XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy is XXXXmmmmSSSSIIIINNNNGGGGLLLLEEEE____SSSSEEEELLLLEEEECCCCTTTT or XXXXmmmmBBBBRRRROOOOWWWWSSSSEEEE____SSSSEEEELLLLEEEECCCCTTTT. Simply returns if XXXXmmmmNNNNllllaaaayyyyoooouuuuttttTTTTyyyyppppeeee is XXXXmmmmSSSSPPPPAAAATTTTIIIIAAAALLLL. Otherwise, this action sets the selection state of all items between the anchor item and the item under the pointer to the selection state of the anchor item. The location cursor is moved to the item under the pointer. If XXXXmmmmNNNNaaaauuuuttttoooommmmaaaattttiiiiccccSSSSeeeelllleeeeccccttttiiiioooonnnn is XXXXmmmmAAAAUUUUTTTTOOOO____SSSSEEEELLLLEEEECCCCTTTT, the XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk(s) is called with either XXXXmmmmCCCCRRRR____MMMMUUUULLLLTTTTIIIIPPPPLLLLEEEE____SSSSEEEELLLLEEEECCCCTTTTor XXXXmmmmCCCCRRRR____EEEEXXXXTTTTEEEENNNNDDDDEEEEDDDD____SSSSEEEELLLLEEEECCCCTTTT as the reason depending on Page 28 (printed 10/3/02) XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX)))) XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy, and with aaaauuuuttttoooo____sssseeeelllleeeeccccttttiiiioooonnnn____ttttyyyyppppeeeeXXXXmmmmAAAAUUUUTTTTOOOO____CCCCHHHHAAAANNNNGGGGEEEE. ContainerBeginSelect(): If this is a second ContainerBeginSelect() action that has occurred within the time specified by the display's multiclick time, this action calls XXXXmmmmNNNNddddeeeeffffaaaauuuullllttttAAAAccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk with reason XXXXmmmmCCCCRRRR____DDDDEEEEFFFFAAAAUUUULLLLTTTT____AAAACCCCTTTTIIIIOOOONNNN and returns. Otherwise, processing depends on the value of XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyyas follows: XXXXmmmmSSSSIIIINNNNGGGGLLLLEEEE____SSSSEEEELLLLEEEECCCCTTTT This action deselects all items and toggles the item (if any) under the pointer. XXXXmmmmBBBBRRRROOOOWWWWSSSSEEEE____SSSSEEEELLLLEEEECCCCTTTT This action deselects all items and toggles the item (if any) under the pointer. This item is now the anchor item for further selection. If XXXXmmmmNNNNaaaauuuuttttoooommmmaaaattttiiiiccccSSSSeeeelllleeeeccccttttiiiioooonnnn is XXXXmmmmAAAAUUUUTTTTOOOO____SSSSEEEELLLLEEEECCCCTTTT and a change in any item's selection state is made, the XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk(s) is called with reason XXXXmmmmCCCCRRRR____BBBBRRRROOOOWWWWSSSSEEEE____SSSSEEEELLLLEEEECCCCTTTT and aaaauuuuttttoooo____sssseeeelllleeeeccccttttiiiioooonnnn____ttttyyyyppppeeee XXXXmmmmAAAAUUUUTTTTOOOO____BBBBEEEEGGGGIIIINNNN. XXXXmmmmMMMMUUUULLLLTTTTIIIIPPPPLLLLEEEE____SSSSEEEELLLLEEEECCCCTTTT If the pointer is over an item and XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnTTTTeeeecccchhhhnnnniiiiqqqquuuueeee is not XXXXmmmmMMMMAAAARRRRQQQQUUUUEEEEEEEE, this action toggles the selection state of that item. The item becomes the anchor item for further selection. If XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnTTTTeeeecccchhhhnnnniiiiqqqquuuueeee is XXXXmmmmMMMMAAAARRRRQQQQUUUUEEEEEEEE, XXXXmmmmMMMMAAAARRRRQQQQUUUUEEEEEEEE____EEEEXXXXTTTTEEEENNNNDDDD____SSSSTTTTAAAARRRRTTTT, or XXXXmmmmMMMMAAAARRRRQQQQUUUUEEEEEEEE____EEEEXXXXTTTTEEEENNNNDDDD____BBBBOOOOTTTTHHHH, this action sets the start point for the Marquee rectangle. If XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnTTTTeeeecccchhhhnnnniiiiqqqquuuueeee is XXXXmmmmMMMMAAAARRRRQQQQUUUUEEEEEEEE____EEEEXXXXTTTTEEEENNNNDDDD____SSSSTTTTAAAARRRRTTTT or XXXXmmmmMMMMAAAARRRRQQQQUUUUEEEEEEEE____EEEEXXXXTTTTEEEENNNNDDDD____BBBBOOOOTTTTHHHH and the pointer is over an item, this action draws the Marquee rectangle around the item. If XXXXmmmmNNNNaaaauuuuttttoooommmmaaaattttiiiiccccSSSSeeeelllleeeeccccttttiiiioooonnnn is XXXXmmmmAAAAUUUUTTTTOOOO____SSSSEEEELLLLEEEECCCCTTTT, the XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk(s) is called with reason XXXXmmmmCCCCRRRR____MMMMUUUULLLLTTTTIIIIPPPPLLLLEEEE____SSSSEEEELLLLEEEECCCCTTTT and aaaauuuuttttoooo____sssseeeelllleeeeccccttttiiiioooonnnn____ttttyyyyppppeeee XXXXmmmmAAAAUUUUTTTTOOOO____BBBBEEEEGGGGIIIINNNN. XXXXmmmmEEEEXXXXTTTTEEEENNNNDDDDEEEEDDDD____SSSSEEEELLLLEEEECCCCTTTT All items are first deselected. Page 29 (printed 10/3/02) XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX)))) Processing is then identical to the case where XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy is XXXXmmmmMMMMUUUULLLLTTTTIIIIPPPPLLLLEEEE____SSSSEEEELLLLEEEECCCCTTTT, except that XXXXmmmmCCCCRRRR____EEEEXXXXTTTTEEEENNNNDDDDEEEEDDDD____SSSSEEEELLLLEEEECCCCTTTT is the callback reason given if XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk is called. ContainerBeginToggle(): Simply returns if XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy is XXXXmmmmSSSSIIIINNNNGGGGLLLLEEEE____SSSSEEEELLLLEEEECCCCTTTT or XXXXmmmmBBBBRRRROOOOWWWWSSSSEEEE____SSSSEEEELLLLEEEECCCCTTTT. Otherwise, if the pointer is over an item and XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnTTTTeeeecccchhhhnnnniiiiqqqquuuueeee is not XXXXmmmmMMMMAAAARRRRQQQQUUUUEEEEEEEE, this action toggles the selection state of that item. The item becomes the anchor item for further selection. If XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnTTTTeeeecccchhhhnnnniiiiqqqquuuueeee is XXXXmmmmMMMMAAAARRRRQQQQUUUUEEEEEEEE, XXXXmmmmMMMMAAAARRRRQQQQUUUUEEEEEEEE____EEEEXXXXTTTTEEEENNNNDDDD____SSSSTTTTAAAARRRRTTTT, or XXXXmmmmMMMMAAAARRRRQQQQUUUUEEEEEEEE____EEEEXXXXTTTTEEEENNNNDDDD____BBBBOOOOTTTTHHHHthis action sets the start point for the Marquee rectangle. If XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnTTTTeeeecccchhhhnnnniiiiqqqquuuueeee is XXXXmmmmMMMMAAAARRRRQQQQUUUUEEEEEEEE____EEEEXXXXTTTTEEEENNNNDDDD____SSSSTTTTAAAARRRRTTTT or XXXXmmmmMMMMAAAARRRRQQQQUUUUEEEEEEEE____EEEEXXXXTTTTEEEENNNNDDDD____BBBBOOOOTTTTHHHH and the pointer is over an item, this action draws the Marquee rectangle around the item. If XXXXmmmmNNNNaaaauuuuttttoooommmmaaaattttiiiiccccSSSSeeeelllleeeeccccttttiiiioooonnnn is XXXXmmmmAAAAUUUUTTTTOOOO____SSSSEEEELLLLEEEECCCCTTTT, the XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk(s) is called with either XXXXmmmmCCCCRRRR____MMMMUUUULLLLTTTTIIIIPPPPLLLLEEEE____SSSSEEEELLLLEEEECCCCTTTTor XXXXmmmmCCCCRRRR____EEEEXXXXTTTTEEEENNNNDDDDEEEEDDDD____SSSSEEEELLLLEEEECCCCTTTT as the reason, depending on XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy, and with aaaauuuuttttoooo____sssseeeelllleeeeccccttttiiiioooonnnn____ttttyyyyppppeeee XXXXmmmmAAAAUUUUTTTTOOOO____BBBBEEEEGGGGIIIINNNN. ContainerButtonMotion(): Processing depends on the value of XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy, as follows: XXXXmmmmSSSSIIIINNNNGGGGLLLLEEEE____SSSSEEEELLLLEEEECCCCTTTT This action simply returns to the caller. XXXXmmmmBBBBRRRROOOOWWWWSSSSEEEE____SSSSEEEELLLLEEEECCCCTTTT Simply returns if this action follows a ContainerBeginExtend()action or ContainerBeginToggle() action. If the pointer is no longer over the current anchor item, this action toggles the current anchor item and then toggles the item under the pointer (if any) and makes it the new anchor item for further processing. If XXXXmmmmNNNNaaaauuuuttttoooommmmaaaattttiiiiccccSSSSeeeelllleeeeccccttttiiiioooonnnn is XXXXmmmmAAAAUUUUTTTTOOOO____SSSSEEEELLLLEEEECCCCTTTT and a change in any item's selection state is made, the XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk(s) is called with reason XXXXmmmmCCCCRRRR____BBBBRRRROOOOWWWWSSSSEEEE____SSSSEEEELLLLEEEECCCCTTTT and Page 30 (printed 10/3/02) XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX)))) aaaauuuuttttoooo____sssseeeelllleeeeccccttttiiiioooonnnn____ttttyyyyppppeeee XXXXmmmmAAAAUUUUTTTTOOOO____MMMMOOOOTTTTIIIIOOOONNNN. XXXXmmmmMMMMUUUULLLLTTTTIIIIPPPPLLLLEEEE____SSSSEEEELLLLEEEECCCCTTTT If a previous action has set a Marquee rectangle start point, this action draws the Marquee rectangle between the current pointer position and the Marquee start point. If the XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnTTTTeeeecccchhhhnnnniiiiqqqquuuueeee is XXXXmmmmMMMMAAAARRRRQQQQUUUUEEEEEEEE____EEEEXXXXTTTTEEEENNNNDDDD____BBBBOOOOTTTTHHHH and the pointer is over an item, the end point of the Marquee rectangle is extended to include the item. The selection states of all items within the Marquee rectangle are toggled to match the state of the anchor item. If no Marquee rectangle start point is set and the pointer is over an item, processing depends on the XXXXmmmmNNNNllllaaaayyyyoooouuuuttttTTTTyyyyppppeeee resource. The anchor item from the previous action is used. If XXXXmmmmNNNNllllaaaayyyyoooouuuuttttTTTTyyyyppppeeee is XXXXmmmmSSSSPPPPAAAATTTTIIIIAAAALLLL, the selection state of the item under the pointer is toggled to match the selection state of the anchor item. If XXXXmmmmNNNNllllaaaayyyyoooouuuuttttTTTTyyyyppppeeee is XXXXmmmmOOOOUUUUTTTTLLLLIIIINNNNEEEE or XXXXmmmmDDDDEEEETTTTAAAAIIIILLLL, the selection state of all items between the anchor item and the item under the pointer are toggled to match the selection state of the anchor item. If XXXXmmmmNNNNaaaauuuuttttoooommmmaaaattttiiiiccccSSSSeeeelllleeeeccccttttiiiioooonnnn is XXXXmmmmAAAAUUUUTTTTOOOO____SSSSEEEELLLLEEEECCCCTTTT and a change in any item's selection state is made, the XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk(s) is called with reason XXXXmmmmCCCCRRRR____MMMMUUUULLLLTTTTIIIIPPPPLLLLEEEE____SSSSEEEELLLLEEEECCCCTTTTand aaaauuuuttttoooo____sssseeeelllleeeeccccttttiiiioooonnnn____ttttyyyyppppeeee XXXXmmmmAAAAUUUUTTTTOOOO____MMMMOOOOTTTTIIIIOOOONNNN. XXXXmmmmEEEEXXXXTTTTEEEENNNNDDDDEEEEDDDD____SSSSEEEELLLLEEEECCCCTTTT Processing is identical to the case where XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy is XXXXmmmmMMMMUUUULLLLTTTTIIIIPPPPLLLLEEEE____SSSSEEEELLLLEEEECCCCTTTT, except that XXXXmmmmCCCCRRRR____EEEEXXXXTTTTEEEENNNNDDDDEEEEDDDD____SSSSEEEELLLLEEEECCCCTTTT is the callback reason given if XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk is called. ContainerCancel(): If a selection is in progress, this action restores selection states of all items to their state before the selection began. If XXXXmmmmNNNNaaaauuuuttttoooommmmaaaattttiiiiccccSSSSeeeelllleeeeccccttttiiiioooonnnn is True and a change in any Page 31 (printed 10/3/02) XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX)))) item's selection state is made, the XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk is called with reason XXXXmmmmCCCCRRRR____BBBBRRRROOOOWWWWSSSSEEEE____SSSSEEEELLLLEEEECCCCTTTT, XXXXmmmmMMMMUUUULLLLTTTTIIIIPPPPLLLLEEEE____SSSSEEEELLLLEEEECCCCTTTT, or XXXXmmmmCCCCRRRR____EEEEXXXXTTTTEEEENNNNDDDDEEEEDDDD____SSSSEEEELLLLEEEECCCCTTTTdepending on the XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy resource and aaaauuuuttttoooo____sssseeeelllleeeeccccttttiiiioooonnnn____ttttyyyyppppeeeeXXXXmmmmAAAAUUUUTTTTOOOO____CCCCAAAANNNNCCCCEEEELLLL. ContainerDeselectAll(): This action deselects all items and calls XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk with reason depending on XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy. ContainerEndExtend(): Simply returns if XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy is XXXXmmmmSSSSIIIINNNNGGGGLLLLEEEE____SSSSEEEELLLLEEEECCCCTTTT or XXXXmmmmBBBBRRRROOOOWWWWSSSSEEEE____SSSSEEEELLLLEEEECCCCTTTT. Simply returns if XXXXmmmmNNNNllllaaaayyyyoooouuuuttttTTTTyyyyppppeeee is XXXXmmmmSSSSPPPPAAAATTTTIIIIAAAALLLL. Otherwise, if XXXXmmmmNNNNaaaauuuuttttoooommmmaaaattttiiiiccccSSSSeeeelllleeeeccccttttiiiioooonnnn is XXXXmmmmNNNNOOOO____AAAAUUUUTTTTOOOO____SSSSEEEELLLLEEEECCCCTTTT, XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk(s) is called with either XXXXmmmmCCCCRRRR____MMMMUUUULLLLTTTTIIIIPPPPLLLLEEEE____SSSSEEEELLLLEEEECCCCTTTTor XXXXmmmmCCCCRRRR____EEEEXXXXTTTTEEEENNNNDDDDEEEEDDDD____SSSSEEEELLLLEEEECCCCTTTT as the reason depending on XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy. If XXXXmmmmNNNNaaaauuuuttttoooommmmaaaattttiiiiccccSSSSeeeelllleeeeccccttttiiiioooonnnn is XXXXmmmmAAAAUUUUTTTTOOOO____SSSSEEEELLLLEEEECCCCTTTT and no change is made in any item's selection state by this action, XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk(s) is called with either XXXXmmmmCCCCRRRR____MMMMUUUULLLLTTTTIIIIPPPPLLLLEEEE____SSSSEEEELLLLEEEECCCCTTTTor XXXXmmmmCCCCRRRR____EEEEXXXXTTTTEEEENNNNDDDDEEEEDDDD____SSSSEEEELLLLEEEECCCCTTTT as the reason depending on XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy and aaaauuuuttttoooo____sssseeeelllleeeeccccttttiiiioooonnnn____ttttyyyyppppeeee XXXXmmmmAAAAUUUUTTTTOOOO____CCCCHHHHAAAANNNNGGGGEEEE. If XXXXmmmmNNNNaaaauuuuttttoooommmmaaaattttiiiiccccSSSSeeeelllleeeeccccttttiiiioooonnnn is XXXXmmmmAAAAUUUUTTTTOOOO____SSSSEEEELLLLEEEECCCCTTTT and this action makes no change in any item's selection state, XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk(s) is called with either XXXXmmmmCCCCRRRR____MMMMUUUULLLLTTTTIIIIPPPPLLLLEEEE____SSSSEEEELLLLEEEECCCCTTTTor XXXXmmmmCCCCRRRR____EEEEXXXXTTTTEEEENNNNDDDDEEEEDDDD____SSSSEEEELLLLEEEECCCCTTTT as the reason depending on XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy and aaaauuuuttttoooo____sssseeeelllleeeeccccttttiiiioooonnnn____ttttyyyyppppeeee XXXXmmmmAAAAUUUUTTTTOOOO____NNNNOOOO____CCCCHHHHAAAANNNNGGGGEEEE. ContainerEndSelect(): Processing depends on the value of XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy, as follows: XXXXmmmmSSSSIIIINNNNGGGGLLLLEEEE____SSSSEEEELLLLEEEECCCCTTTT This action calls XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkkwith reason XXXXmmmmCCCCRRRR____SSSSIIIINNNNGGGGLLLLEEEE____SSSSEEEELLLLEEEECCCCTTTT. XXXXmmmmBBBBRRRROOOOWWWWSSSSEEEE____SSSSEEEELLLLEEEECCCCTTTT If the pointer is no longer over the current anchor item, this action toggles the current anchor item and then toggles the item under the pointer (if any). If XXXXmmmmNNNNaaaauuuuttttoooommmmaaaattttiiiiccccSSSSeeeelllleeeeccccttttiiiioooonnnn is XXXXmmmmNNNNOOOO____AAAAUUUUTTTTOOOO____SSSSEEEELLLLEEEECCCCTTTT, the XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk(s) is called with Page 32 (printed 10/3/02) XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX)))) reason XXXXmmmmCCCCRRRR____BBBBRRRROOOOWWWWSSSSEEEE____SSSSEEEELLLLEEEECCCCTTTT. If XXXXmmmmNNNNaaaauuuuttttoooommmmaaaattttiiiiccccSSSSeeeelllleeeeccccttttiiiioooonnnn is XXXXmmmmAAAAUUUUTTTTOOOO____SSSSEEEELLLLEEEECCCCTTTT and a change in any item's selection state is made, XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk(s) is called with reason XXXXmmmmCCCCRRRR____BBBBRRRROOOOWWWWSSSSEEEE____SSSSEEEELLLLEEEECCCCTTTT and aaaauuuuttttoooo____sssseeeelllleeeeccccttttiiiioooonnnn____ttttyyyyppppeeee XXXXmmmmAAAAUUUUTTTTOOOO____CCCCHHHHAAAANNNNGGGGEEEE. If XXXXmmmmNNNNaaaauuuuttttoooommmmaaaattttiiiiccccSSSSeeeelllleeeeccccttttiiiioooonnnn is XXXXmmmmAAAAUUUUTTTTOOOO____SSSSEEEELLLLEEEECCCCTTTT and no change is made in any item's selection state by this action, XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk(s) is called with reason XXXXmmmmCCCCRRRR____BBBBRRRROOOOWWWWSSSSEEEE____SSSSEEEELLLLEEEECCCCTTTT and aaaauuuuttttoooo____sssseeeelllleeeeccccttttiiiioooonnnn____ttttyyyyppppeeee XXXXmmmmAAAAUUUUTTTTOOOO____NNNNOOOO____CCCCHHHHAAAANNNNGGGGEEEE. XXXXmmmmMMMMUUUULLLLTTTTIIIIPPPPLLLLEEEE____SSSSEEEELLLLEEEECCCCTTTT This action first performs the same processing as the ContainerButtonMotion()action, except that XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk is not called. If XXXXmmmmNNNNaaaauuuuttttoooommmmaaaattttiiiiccccSSSSeeeelllleeeeccccttttiiiioooonnnn is XXXXmmmmNNNNOOOO____AAAAUUUUTTTTOOOO____SSSSEEEELLLLEEEECCCCTTTT, the XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk(s) is called with reason XXXXmmmmCCCCRRRR____MMMMUUUULLLLTTTTIIIIPPPPLLLLEEEE____SSSSEEEELLLLEEEECCCCTTTT. If XXXXmmmmNNNNaaaauuuuttttoooommmmaaaattttiiiiccccSSSSeeeelllleeeeccccttttiiiioooonnnn is XXXXmmmmAAAAUUUUTTTTOOOO____SSSSEEEELLLLEEEECCCCTTTT and a change in any item's selection state is made, the XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk(s) is called with reason XXXXmmmmCCCCRRRR____MMMMUUUULLLLTTTTIIIIPPPPLLLLEEEE____SSSSEEEELLLLEEEECCCCTTTT and aaaauuuuttttoooo____sssseeeelllleeeeccccttttiiiioooonnnn____ttttyyyyppppeeee XXXXmmmmAAAAUUUUTTTTOOOO____CCCCHHHHAAAANNNNGGGGEEEE. If XXXXmmmmNNNNaaaauuuuttttoooommmmaaaattttiiiiccccSSSSeeeelllleeeeccccttttiiiioooonnnn is XXXXmmmmAAAAUUUUTTTTOOOO____SSSSEEEELLLLEEEECCCCTTTT and this action makes no change in any item's selection state, XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk(s) is called with reason XXXXmmmmCCCCRRRR____MMMMUUUULLLLTTTTIIIIPPPPLLLLEEEE____SSSSEEEELLLLEEEECCCCTTTT and aaaauuuuttttoooo____sssseeeelllleeeeccccttttiiiioooonnnn____ttttyyyyppppeeee XXXXmmmmAAAAUUUUTTTTOOOO____NNNNOOOO____CCCCHHHHAAAANNNNGGGGEEEE. XXXXmmmmEEEEXXXXTTTTEEEENNNNDDDDEEEEDDDD____SSSSEEEELLLLEEEECCCCTTTT This action first performs the same processing as the ContainerButtonMotion()action, except that XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk is not called. If XXXXmmmmNNNNaaaauuuuttttoooommmmaaaattttiiiiccccSSSSeeeelllleeeeccccttttiiiioooonnnn is XXXXmmmmNNNNOOOO____AAAAUUUUTTTTOOOO____SSSSEEEELLLLEEEECCCCTTTT, the XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk(s) is called with reason XXXXmmmmCCCCRRRR____EEEEXXXXTTTTEEEENNNNDDDDEEEEDDDD____SSSSEEEELLLLEEEECCCCTTTT. If XXXXmmmmNNNNaaaauuuuttttoooommmmaaaattttiiiiccccSSSSeeeelllleeeeccccttttiiiioooonnnn is XXXXmmmmAAAAUUUUTTTTOOOO____SSSSEEEELLLLEEEECCCCTTTT and a change in any item's selection state is made, XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk(s) is called with reason XXXXmmmmCCCCRRRR____EEEEXXXXTTTTEEEENNNNDDDDEEEEDDDD____SSSSEEEELLLLEEEECCCCTTTT and aaaauuuuttttoooo____sssseeeelllleeeeccccttttiiiioooonnnn____ttttyyyyppppeeee XXXXmmmmAAAAUUUUTTTTOOOO____CCCCHHHHAAAANNNNGGGGEEEE. If XXXXmmmmNNNNaaaauuuuttttoooommmmaaaattttiiiiccccSSSSeeeelllleeeeccccttttiiiioooonnnn is XXXXmmmmAAAAUUUUTTTTOOOO____SSSSEEEELLLLEEEECCCCTTTT Page 33 (printed 10/3/02) XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX)))) and this action makes no change in any item's selection state, XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk(s) is called with reason XXXXmmmmCCCCRRRR____EEEEXXXXTTTTEEEENNNNDDDDEEEEDDDD____SSSSEEEELLLLEEEECCCCTTTT and aaaauuuuttttoooo____sssseeeelllleeeeccccttttiiiioooonnnn____ttttyyyyppppeeee XXXXmmmmAAAAUUUUTTTTOOOO____NNNNOOOO____CCCCHHHHAAAANNNNGGGGEEEE. ContainerEndToggle(): Simply returns if XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy is XXXXmmmmSSSSIIIINNNNGGGGLLLLEEEE____SSSSEEEELLLLEEEECCCCTTTT or XXXXmmmmBBBBRRRROOOOWWWWSSSSEEEE____SSSSEEEELLLLEEEECCCCTTTT. If XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy is XXXXmmmmMMMMUUUULLLLTTTTIIIIPPPPLLLLEEEE____SSSSEEEELLLLEEEECCCCTTTT or XXXXmmmmEEEEXXXXTTTTEEEENNNNDDDDEEEEDDDD____SSSSEEEELLLLEEEECCCCTTTT, this action performs the same processing as the ContainerEndSelect() action. ContainerEndTransfer():: If the elapsed time since a ContainerStartTransfer()action has occurred exceeds the time span specified by the display's multiclick time, this action returns. Otherwise, the ContainerPrimaryCopy(), ContainerPrimaryLink(), or ContainerPrimaryMove() action is invoked, depending on the value of the operation parameter saved by ContainerStartTransfer(). ContainerExpandOrCollapse(_L_e_f_t|_R_i_g_h_t|_C_o_l_l_a_p_s_e|_E_x_p_a_n_d): This action changes the value of the XXXXmmmmNNNNoooouuuuttttlllliiiinnnneeeeSSSSttttaaaatttteeee of the current focus widget. If the argument value is CCCCoooollllllllaaaappppsssseeee or LLLLeeeefffftttt, the XXXXmmmmNNNNoooouuuuttttlllliiiinnnneeeeSSSSttttaaaatttteeee resource value is set to XXXXmmmmCCCCOOOOLLLLLLLLAAAAPPPPSSSSEEEEDDDD. If the argument value is EEEExxxxppppaaaannnnddddor RRRRiiiigggghhhhtttt, the XXXXmmmmNNNNoooouuuuttttlllliiiinnnneeeeSSSSttttaaaatttteeee resource value is set to XXXXmmmmEEEEXXXXPPPPAAAANNNNDDDDEEEEDDDD. If the argument is LLLLeeeefffftttt or RRRRiiiigggghhhhtttt and the layout is right to left, then the setting of the XXXXmmmmNNNNoooouuuuttttlllliiiinnnneeeeSSSSttttaaaatttteeee value is reversed from that described in the preceding paragraph. Simply returns if XXXXmmmmNNNNllllaaaayyyyoooouuuuttttTTTTyyyyppppeeee is XXXXmmmmSSSSPPPPAAAATTTTIIIIAAAALLLL. ContainerExtend(): Processing depends on the value of XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy, as follows: If the selection policy is XXXXmmmmSSSSIIIINNNNGGGGLLLLEEEE____SSSSEEEELLLLEEEECCCCTTTT or XXXXmmmmBBBBRRRROOOOWWWWSSSSEEEE____SSSSEEEELLLLEEEECCCCTTTT, this action returns. If XXXXmmmmNNNNllllaaaayyyyoooouuuuttttTTTTyyyyppppeeee is XXXXmmmmSSSSPPPPAAAATTTTIIIIAAAALLLL, this action returns. If the selection policy is XXXXmmmmMMMMUUUULLLLTTTTIIIIPPPPLLLLEEEE____SSSSEEEELLLLEEEECCCCTTTT, this action sets the selection state of all items between the anchor item and the location cursor to Page 34 (printed 10/3/02) XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX)))) the selection state of the anchor item. If the selection policy is XXXXmmmmEEEEXXXXTTTTEEEENNNNDDDDEEEEDDDD____SSSSEEEELLLLEEEECCCCTTTT and the Container is in Normal Mode, this action deselects all items and selects all items between the anchor item and the location cursor. If the selection policy is XXXXmmmmEEEEXXXXTTTTEEEENNNNDDDDEEEEDDDD____SSSSEEEELLLLEEEECCCCTTTT and the Container is in Add Mode, this action sets the selection state of all items between the anchor item and the location cursor to the selection state of the anchor item. XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk is called with reason XXXXmmmmCCCCRRRR____MMMMUUUULLLLTTTTIIIIPPPPLLLLEEEE____SSSSEEEELLLLEEEECCCCTTTTor XXXXmmmmCCCCRRRR____EEEEXXXXTTTTEEEENNNNDDDDEEEEDDDD____SSSSEEEELLLLEEEECCCCTTTT depending on XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy. ContainerExtendCursor(_L_e_f_t|_R_i_g_h_t|_U_p|_D_o_w_n): Processing depends on the value of XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy, as follows: If the selection policy is XXXXmmmmSSSSIIIINNNNGGGGLLLLEEEE____SSSSEEEELLLLEEEECCCCTTTT or XXXXmmmmBBBBRRRROOOOWWWWSSSSEEEE____SSSSEEEELLLLEEEECCCCTTTT, this action returns. If XXXXmmmmNNNNllllaaaayyyyoooouuuuttttTTTTyyyyppppeeee is XXXXmmmmSSSSPPPPAAAATTTTIIIIAAAALLLL, this action returns. This action moves the location cursor one item in the indicated direction, if possible. If the value of the argument string is FFFFiiiirrrrsssstttt or LLLLaaaasssstttt, this action moves the location cursor to the indicated item. For other values of the argument string, the location cursor is not affected. If the selection policy is XXXXmmmmMMMMUUUULLLLTTTTIIIIPPPPLLLLEEEE____SSSSEEEELLLLEEEECCCCTTTT, this action sets the selection state of all items between the anchor item and the location cursor to the selection state of the anchor item. If the selection policy is XXXXmmmmEEEEXXXXTTTTEEEENNNNDDDDEEEEDDDD____SSSSEEEELLLLEEEECCCCTTTT and the Container is in Normal Mode, this action deselects all items and selects all items between the anchor item and the location cursor. If the selection policy is XXXXmmmmEEEEXXXXTTTTEEEENNNNDDDDEEEEDDDD____SSSSEEEELLLLEEEECCCCTTTT and the Container is in Add Mode, this action sets the selection state of all items between the anchor item and the location cursor to the selection state of the anchor item. XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk is called with reason XXXXmmmmCCCCRRRR____MMMMUUUULLLLTTTTIIIIPPPPLLLLEEEE____SSSSEEEELLLLEEEECCCCTTTTor XXXXmmmmCCCCRRRR____EEEEXXXXTTTTEEEENNNNDDDDEEEEDDDD____SSSSEEEELLLLEEEECCCCTTTT depending on XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy. ContainerHandleBtn1Down(_s_t_r_i_n_g)))) When Display's XXXXmmmmNNNNeeeennnnaaaabbbblllleeeeBBBBttttnnnn1111TTTTrrrraaaannnnssssffffeeeerrrr resource is Page 35 (printed 10/3/02) XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX)))) not XXXXmmmmOOOOFFFFFFFF, the actions for selection and transfer are integrated on <<<<BBBBttttnnnn1111>>>>. If the pointer is over an unselected item or background, the item is first selected before the transfer is started. Otherwise, if the item is already selected, the transfer is started. The value of _s_t_r_i_n_g can be one of the following actions: +o CCCCoooonnnnttttaaaaiiiinnnneeeerrrrBBBBeeeeggggiiiinnnnSSSSeeeelllleeeecccctttt,,,,CCCCooooppppyyyy +o CCCCoooonnnnttttaaaaiiiinnnneeeerrrrBBBBeeeeggggiiiinnnnTTTToooogggggggglllleeee,,,,CCCCooooppppyyyy +o CCCCoooonnnnttttaaaaiiiinnnneeeerrrrNNNNoooooooopppp,,,,LLLLiiiinnnnkkkk +o CCCCoooonnnnttttaaaaiiiinnnneeeerrrrBBBBeeeeggggiiiinnnnEEEExxxxtttteeeennnndddd,,,,MMMMoooovvvveeee ContainerHandleBtn1Motion(_s_t_r_i_n_g)))) When Display's XXXXmmmmNNNNeeeennnnaaaabbbblllleeeeBBBBttttnnnn1111TTTTrrrraaaannnnssssffffeeeerrrr resource is not XXXXmmmmOOOOFFFFFFFF, the actions for selection and transfer are integrated on <<<<BBBBttttnnnn1111>>>>. When this action is invoked, and a selection is in progress, a drag is performed. Otherwise, the default action as specified in _s_t_r_i_n_g is performed. The value of _s_t_r_i_n_gcan be CCCCoooonnnnttttaaaaiiiinnnneeeerrrrBBBBuuuuttttttttoooonnnnMMMMoooottttiiiioooonnnn. ContainerHandleBtn1Up(_s_t_r_i_n_g)))) If a Button 1 transfer was in progress, then when this action is invoked, that transfer is cancelled. Otherwise, the default action as specified in _s_t_r_i_n_g is performed. The value of _s_t_r_i_n_gcan be one of the following actions: +o CCCCoooonnnnttttaaaaiiiinnnneeeerrrrEEEEnnnnddddSSSSeeeelllleeeecccctttt +o CCCCoooonnnnttttaaaaiiiinnnneeeerrrrEEEEnnnnddddTTTToooogggggggglllleeee +o CCCCoooonnnnttttaaaaiiiinnnneeeerrrrEEEEnnnnddddEEEExxxxtttteeeennnndddd ContainerHandleBtn2Down(_s_t_r_i_n_g)))) When Display's XXXXmmmmNNNNeeeennnnaaaabbbblllleeeeBBBBttttnnnn1111TTTTrrrraaaannnnssssffffeeeerrrr resource has a value of _X_m_B_U_T_T_O_N_2__A_D_J_U_S_T, the actions for extending selection are bound on <<<<BBBBttttnnnn2222>>>>. Otherwise, the action that is performed depends on the value of _s_t_r_i_n_g, which can be one of the following actions: +o CCCCoooonnnnttttaaaaiiiinnnneeeerrrrSSSSttttaaaarrrrttttTTTTrrrraaaannnnssssffffeeeerrrr,,,,CCCCooooppppyyyy +o CCCCoooonnnnttttaaaaiiiinnnneeeerrrrSSSSttttaaaarrrrttttTTTTrrrraaaannnnssssffffeeeerrrr,,,,LLLLiiiinnnnkkkk +o CCCCoooonnnnttttaaaaiiiinnnneeeerrrrSSSSttttaaaarrrrttttTTTTrrrraaaannnnssssffffeeeerrrr,,,,MMMMoooovvvveeee Page 36 (printed 10/3/02) XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX)))) ContainerHandleBtn2Motion(_s_t_r_i_n_g)))) When Display's XXXXmmmmNNNNeeeennnnaaaabbbblllleeeeBBBBttttnnnn1111TTTTrrrraaaannnnssssffffeeeerrrr resource is not _X_m_B_U_T_T_O_N_2__A_D_J_U_S_T, and a selection is in progress, a drag is performed. Otherwise, the default action that is performed depends on the value of _s_t_r_i_n_g, which can be CCCCoooonnnnttttaaaaiiiinnnneeeerrrrBBBBuuuuttttttttoooonnnnMMMMoooottttiiiioooonnnn. ContainerHandleBtn2Up(_s_t_r_i_n_g)))) When Display's XXXXmmmmNNNNeeeennnnaaaabbbblllleeeeBBBBttttnnnn1111TTTTrrrraaaannnnssssffffeeeerrrr resource has a value of _X_m_B_U_T_T_O_N_2__A_D_J_U_S_T, this action ends an extend. Otherwise, the action that is performed depends on the value of _s_t_r_i_n_g, which can be CCCCoooonnnnttttaaaaiiiinnnneeeerrrrEEEEnnnnddddTTTTrrrraaaannnnssssffffeeeerrrr. ContainerMoveCursor(_L_e_f_t|_R_i_g_h_t|_U_p|_D_o_w_n|_F_i_r_s_t|_L_a_s_t): If the argument is LLLLeeeefffftttt, RRRRiiiigggghhhhtttt, UUUUpppp, or DDDDoooowwwwnnnn, this action moves the location cursor one item in the indicated direction, if possible. If the value of the argument string is FFFFiiiirrrrsssstttt or LLLLaaaasssstttt, this action moves the location cursor to the indicated item. Any other arguments are ignored. If XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy is XXXXmmmmBBBBRRRROOOOWWWWSSSSEEEE____SSSSEEEELLLLEEEECCCCTTTT, or if XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy is XXXXmmmmEEEEXXXXTTTTEEEENNNNDDDDEEEEDDDD____SSSSEEEELLLLEEEECCCCTTTT and the Container is in Normal Mode, this action deselects all items, selects the item at the location cursor, and calls XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk with the reason depending on XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy. ContainerPrimaryCopy(): This action requests that primary selection data be copied to the Container. This action calls the XXXXmmmmNNNNddddeeeessssttttiiiinnnnaaaattttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk procedures for the _P_R_I_M_A_R_Y selection and the XXXXmmmmCCCCOOOOPPPPYYYY operation. By default, the Container does not do any transfer, and copying the selection is the responsibility of the XXXXmmmmNNNNddddeeeessssttttiiiinnnnaaaattttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkkprocedures. ContainerPrimaryLink(): This action requests that primary selection data be linked to the Container. This action calls the XXXXmmmmNNNNddddeeeessssttttiiiinnnnaaaattttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk procedures for the _P_R_I_M_A_R_Y selection and the XXXXmmmmLLLLIIIINNNNKKKK operation. By default, the Container does not do any transfer, and linking the selection is the responsibility of the XXXXmmmmNNNNddddeeeessssttttiiiinnnnaaaattttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkkprocedures. ContainerPrimaryMove(): This action requests that primary selection data be copied to the Container and deleted from the primary source. This action calls the Page 37 (printed 10/3/02) XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX)))) XXXXmmmmNNNNddddeeeessssttttiiiinnnnaaaattttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk procedures for the _P_R_I_M_A_R_Y selection and the XXXXmmmmMMMMOOOOVVVVEEEE operation. By default, the Container does not do any transfer, and moving the selection is the responsibility of the XXXXmmmmNNNNddddeeeessssttttiiiinnnnaaaattttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkkprocedures. If the transfer is successful, this action then calls the selection owner's XXXXmmmmNNNNccccoooonnnnvvvveeeerrrrttttCCCCaaaallllllllbbbbaaaacccckkkk procedures for the _P_R_I_M_A_R_Yselection and the _D_E_L_E_T_E target. ContainerSelect(): Processing depends on the value of XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy, as follows: If the selection policy is XXXXmmmmSSSSIIIINNNNGGGGLLLLEEEE____SSSSEEEELLLLEEEECCCCTTTT or XXXXmmmmBBBBRRRROOOOWWWWSSSSEEEE____SSSSEEEELLLLEEEECCCCTTTT, this action deselects all items and selects the item at the location cursor. If the selection policy is XXXXmmmmMMMMUUUULLLLTTTTIIIIPPPPLLLLEEEE____SSSSEEEELLLLEEEECCCCTTTT, this action toggles the selection state of the item at the location cursor. This item becomes the anchor item for further selections. If the selection policy is XXXXmmmmEEEEXXXXTTTTEEEENNNNDDDDEEEEDDDD____SSSSEEEELLLLEEEECCCCTTTT and the Container is in Normal Mode, this action deselects all items and selects the item at the location cursor. If the selection policy is XXXXmmmmEEEEXXXXTTTTEEEENNNNDDDDEEEEDDDD____SSSSEEEELLLLEEEECCCCTTTT and the Container is in Add Mode, this action toggles the selection state of the item at the location cursor. The selected/toggled item becomes the anchor item for further selections. XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk is called with the reason depending on XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy. ContainerSelectAll(): If XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy is XXXXmmmmSSSSIIIINNNNGGGGLLLLEEEE____SSSSEEEELLLLEEEECCCCTTTT or XXXXmmmmBBBBRRRROOOOWWWWSSSSEEEE____SSSSEEEELLLLEEEECCCCTTTT, this action deselects all items and selects the item at the location cursor position. If XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy is XXXXmmmmMMMMUUUULLLLTTTTIIIIPPPPLLLLEEEE____SSSSEEEELLLLEEEECCCCTTTTor XXXXmmmmEEEEXXXXTTTTEEEENNNNDDDDEEEEDDDD____SSSSEEEELLLLEEEECCCCTTTT, this action selects all items. XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk is called with the reason depending on the value of XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk. ContainerStartTransfer(_C_o_p_y|_M_o_v_e|_L_i_n_k): This action saves the event and the operation specified in the argument string for use by subsequent actions. If no ContainerEndTransfer() actions occur within the time span specified by Page 38 (printed 10/3/02) XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX)))) the display's multiclick time and if XXXXmmmmNNNNllllaaaayyyyoooouuuuttttTTTTyyyyppppeeeeis XXXXmmmmSSSSPPPPAAAATTTTIIIIAAAALLLL, this action creates a DragContext and starts a drag transfer by using _s_t_r_i_n_g to specify the transfer operation. If no argument string is specified, CCCCooooppppyyyy is the default value. Unless default drag and drop behavior has been overridden by a XXXXmmmmNNNNccccoooonnnnvvvveeeerrrrttttCCCCaaaallllllllbbbbaaaacccckkkk procedure, if the drop operation occurs within the Container, then the item(s) being dragged are relocated at the position of the drop operation. If the item targeted by the Drag operation is not in the selected state, then only that item is moved. If the item is in the selected state, however, all items in the selected state are moved. ContainerToggleMode(): If XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy is XXXXmmmmEEEEXXXXTTTTEEEENNNNDDDDEEEEDDDD____SSSSEEEELLLLEEEECCCCTTTT, this action toggles the Container between Normal Mode and Add Mode. AAAAddddddddiiiittttiiiioooonnnnaaaallll BBBBeeeehhhhaaaavvvviiiioooorrrr The Container widget has the following additional behavior: <<<<BBBBttttnnnn1111DDDDoooowwwwnnnn>>>>((((2222++++)))) If a button click is followed by another button click within the time span specified by the display's multiclick time, the Container interprets that as a double-click and calls the XXXXmmmmNNNNddddeeeeffffaaaauuuullllttttAAAAccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk callbacks. <<<<FFFFooooccccuuuussssIIIInnnn>>>>: If the focus policy is explicit, sets the focus and draws the location cursor. <<<<FFFFooooccccuuuussssOOOOuuuutttt>>>>: If the focus policy is explicit, removes the focus and erases the location cursor. VVVViiiirrrrttttuuuuaaaallll BBBBiiiinnnnddddiiiinnnnggggssss The bindings for virtual keys are vendor specific. For information about bindings for virtual buttons and keys, see VVVViiiirrrrttttuuuuaaaallllBBBBiiiinnnnddddiiiinnnnggggssss(3). RRRREEEELLLLAAAATTTTEEEEDDDD CCCCoooommmmppppoooossssiiiitttteeee(3), CCCCoooonnnnssssttttrrrraaaaiiiinnnntttt(3), CCCCoooorrrreeee(3), XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrrCCCCooooppppyyyy, XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrrCCCCooooppppyyyyLLLLiiiinnnnkkkk, XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrrCCCCuuuutttt, XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrrGGGGeeeettttIIIItttteeeemmmmCCCChhhhiiiillllddddrrrreeeennnn, XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrrPPPPaaaasssstttteeee, XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrrPPPPaaaasssstttteeeeLLLLiiiinnnnkkkk, XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrrRRRReeeellllaaaayyyyoooouuuutttt(3), XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrrRRRReeeeoooorrrrddddeeeerrrr(3), XXXXmmmmCCCCrrrreeeeaaaatttteeeeCCCCoooonnnnttttaaaaiiiinnnneeeerrrr(3), XXXXmmmmCCCCrrrreeeeaaaatttteeeeIIIIccccoooonnnnGGGGaaaaddddggggeeeetttt(3), XXXXmmmmIIIIccccoooonnnnGGGGaaaaddddggggeeeetttt(3), and XXXXmmmmMMMMaaaannnnaaaaggggeeeerrrr(3). Page 39 (printed 10/3/02)